Seedream 5.0 Pro

Seedream 5.0 Pro は ByteDance の画像モデルです。1 回のリクエストで、プロンプトから、またはプロンプトと最大 10 枚の参照画像から画像を 1 枚生成するほか、画像を 1 枚、背景のベース画像と最大 16 枚の透明レイヤーに分解できます。リクエストを送信し、返されたタスク ID を保持して、完成した画像をタスクから読み取ってください。参照画像は URL で渡します。

モデル ID

現在の料金はモデルページをご覧ください。

クイックサンプル

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

エンドポイント

POST https://api.seedrouter.ai/v1/images/generations

レスポンスはタスク（{"id": "task_...", "status": "processing"}）であり、完成した画像ではありません。結果は GET /v1/tasks/{task_id} をポーリングして取得してください。API キーはサーバー側のコードで保持してください。参照画像とレイヤー分解は同じリクエストの image で渡します。このモデルでは /v1/images/edits は使わず、400 が返されます。

パラメータ

この一覧にないフィールドはリクエスト転送前に削除され、エラーの原因にも出力の変更にもなりません。n、stream、seed、response_format、連続生成は利用できません。callback_url は利用できません。代わりにタスクをポーリングしてください。

出力サイズ

解像度区分で規模が決まり、プロンプトで形が決まります。prompt にアスペクト比（例えば「16:9 の横長画像」）を書くと、モデルがフレームを選びます：

固定フレームには、解像度区分の代わりにピクセル寸法を送信してください。1K と 1.5K は同料金です。2K や 261 万ピクセルを超えるサイズは高い料金になります（料金の要素を参照）。

参照画像

編集する画像を 1 枚、組み合わせる画像を 2–10 枚渡し、prompt で維持する部分と変更する部分を指定してください。「画像 1 のジャケット」のように、画像は順番で参照します。

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

レイヤー分解

layer_decomposition: true と画像を必ず 1 枚送信してください。タスクは最初に背景のベース画像を返し、続いて各レイヤーを透明 PNG として返します。

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

各レイヤーに z_index（背景のベース画像は 0、大きい番号ほど上）、name、description、bounding_box が含まれます。bounding_box.absolute は背景のベース画像のピクセル単位の [left, top, right, bottom] です。bounding_box.normalized は同じ領域を、背景のベース画像の幅と高さをそれぞれ千等分した単位で示します。画像を再構成するには、各レイヤーをボックスのサイズに合わせ、z_index の昇順に背景のベース画像に配置してください。

size: "auto" では、背景のベース画像と各レイヤーが入力画像内のサイズを維持します。入力は PNG または JPEG で、総ピクセル数（幅 × 高さ）は 262,144（512 × 512）〜36,000,000（6000 × 6000）の範囲である必要があります。

透明な背景

アルファチャンネルのある PNG を 1 枚、background: "transparent" とともに送信すると、背景が透明な PNG を取得できます：

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

メディア入力

各参照画像は公開 HTTP(S) URL で渡します。Base64 の data URI は受け付けません。ファイルを自分のストレージにアップロードし、その URL を渡してください。対応形式は JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF です。各画像は最大 30 MB、アスペクト比 1:16〜16:1、幅・高さともに 14 ピクセル超、総ピクセル数は最大 36,000,000 です。レイヤー分解は PNG または JPEG のみ対応します。

料金の要素

現在のレートはモデルの料金セクションをご覧ください。Seedream 5.0 Pro は、用途とピクセル数による料金区分に応じて出力画像 1 枚ごとに課金され、参照画像は 二枚目以降に追加料金がかかります：

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• 低い料金区分は 261 万ピクセル以下（1.5K 以下）です。それを超える画像は高い料金区分になります。
• レイヤー分解は背景のベース画像と各レイヤーが課金対象です。リクエスト全体で同じ料金区分を使い、返された画像がすべて 261 万ピクセル以内の場合のみ低料金になります。
• タスク受理時の確保額は最大の結果を想定しています。通常は指定した料金区分の画像 1 枚分、レイヤー分解は 17 枚分です（auto は高い料金区分として計算）。その後、実際に返された画像分を課金し、差額を解放します。

最終的な課金額はアカウントの利用履歴で確認できます。失敗したタスクは課金されません。

出力スキーマ

送信するとタスクが返されます：

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

タスクを取得する

GET https://api.seedrouter.ai/v1/tasks/{task_id}

status が completed または failed になるまで、10〜20 秒ごとにポーリングしてください。ポーリング中のネットワークタイムアウトは生成の失敗を意味しません。タスク ID を保持して確認を再開してください。進捗確認のために別のタスクを作成しないでください。

完了したタスク

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

レイヤー分解タスクでは、背景のベース画像、各レイヤーの順に表示されます：

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

私たちのテストでは 1K 画像は約 35〜55 秒、背景のベース画像と 13 レイヤーを返した 1K のレイヤー分解は約 140 秒でした。

エラー

タスク作成前に拒否されたリクエストは、HTTP エラーと error オブジェクトを返し、課金されません。受理後に失敗したタスクは、照会時に HTTP 200 と status: "failed"、そして error オブジェクトを返します。

コード・HTTP ステータス・リトライの指針は共通エラーカタログを参照してください。

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

送信自体がタイムアウトした場合は、再送信の前にタスクを確認してください。最初のリクエストが受理されている可能性があります。

ヒント

• 試作は 1K または 1.5K で始めてください。1.5K と 1K は同料金です。
• 解像度区分を使う場合はプロンプトで形を指定し、固定レイアウトにはピクセル寸法を送信してください。
• 複数の参照画像を使う場合は、それぞれから何を取り入れるかを指定し、画像を順番で参照してください。
• マークなしの画像が必要なら watermark: false を指定してください。デフォルトではマークが付きます。
• レイヤー分解では、レイヤー数を抑えるため、分けたい要素を列挙してください。

関連情報

• Seedream 5.0 Pro の Playground と料金
• OpenAPI をダウンロード
• コピー可能な Markdown