Seedream 5.5 API ガイド：価格、パラメータ、呼び出し例

Seedream 5.5 でできること

Seedream 5.5 は HiAPI 上の画像モデルで、1 つのモデル ID（seedream-5.5）が 2 つの使い方を同時にカバーします。プロンプトだけを書けばテキストからの画像生成になり、参照画像を添付すれば参照画像に基づく編集や画面内容の保持になります。どちらの使い方も同じエンドポイント、同じパラメータセットを使い、違いはリクエストに image_urls があるかどうかだけです。

1 回の呼び出しで 1 枚の画像を返します。以下では「価格の計算方法 → パラメータの入力方法 → リクエストの送信方法 → 制限事項」の順に説明します。すべての数値は本記事執筆時点の API 定義に基づきます。

価格：ピクセル帯ごとの課金、参照画像は 1 枚ごとに追加課金

費用は 2 つの部分から成ります。出力帯の基本料金に、参照画像の料金を加えたものです。

• 1K / 1.5K：$0.0186 / 枚
• 2K（デフォルト帯）：$0.0325 / 枚
• 参照画像：1 枚につき $0.0075、1 枚目も課金、最大 10 枚

いくつか例を挙げます：

• 1K のテキストからの画像生成、参照画像なし：$0.0186
• 2K、参照画像 1 枚付き：$0.0325 + $0.0075 = $0.04
• 2K、参照画像 10 枚付き（上限）：$0.0325 + $0.075 = $0.1075

size を指定しない場合は 2K で出力され、2K として課金されます。下書きや小サイズの挿絵を作るだけなら、明示的に "size": "1K" と書くことで約 4 割を節約できます。タスクが失敗した場合は料金が全額返金されます。

パラメータ一覧

model と prompt 以外はすべて任意パラメータです：

• prompt：必須、1〜5000 文字。生成する画面を記述します。参照画像がある場合は、何を変更し何を保持するかを明確に書きます。
• size：1K、1.5K、2K、デフォルトは 2K。
• aspect_ratio：10 種類から選択——1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、2:1、1:2。指定しない場合はモデルがプロンプトと参照画像に基づいて自動選択します。
• image_urls：1〜10 個の公開アクセス可能な http(s) 画像 URL。指定しない場合は純粋なテキスト生成になります。
• output_format：png または jpeg、デフォルトは png。
• background：auto、transparent、opaque、デフォルトは auto。transparent を選ぶ場合、出力形式は png のみ可能で、jpeg と組み合わせると拒否されます。

リクエストを送信する

HiAPI の画像タスクは非同期です。まずタスクを作成し、次に結果を照会します。model はトップレベルに置き、残りのパラメータは input に入れます。

テキストからの画像生成（2K、16:9）：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "清晨的海边灯塔，薄雾，柔和的侧光，写实摄影风格",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

参照画像編集（1K、透明背景、PNG）：

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "保留瓶身和标签，去掉背景，换成柔和的顶光",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

この注文の費用は $0.0186 + $0.0075 = $0.0261 です。作成に成功したら、返却されたタスク ID を使って GET https://api.hiapi.ai/v1/tasks/{taskId} をポーリングし、ステータスが成功になったら出力から画像 URL を取得してダウンロードします。

現在の制限

• 最大 2K までで、4K 帯はありません。
• 画像のレイヤー出力には対応していません。
• 1 回の呼び出しで 1 枚の画像のみ出力されます。複数枚必要な場合は複数のタスクを並行して送信してください。
• 参照画像は公衆インターネットからアクセス可能な http(s) アドレスである必要があり、ローカルファイルパスや base64 は受け付けません。
• 透明背景は PNG のみ対応です。

帯の選び方

そのまま公開するポスターや商品メイン画像にはデフォルトの 2K を使います。社内レビュー用の稿、スタイルの一括試行、小サイズのサムネイルには 1K または 1.5K を使います（両者は同価格で、1.5K のほうが鮮明なので、1K を選ぶ理由がない場合は 1.5K をそのまま使ってください）。参照画像は 1 枚ごとに課金されるので、結果に本当に影響する数枚だけを入れます。同じ商品の多角度画像は、まず 1〜2 枚で試し、効果が足りなければ追加します。