Seedream 5.0 Pro

Seedream 5.0 Pro は、プロンプトから画像を 1 枚生成し、最大 10 枚の参照画像を編集・合成できます。1 枚の画像をベース画像と最大 16 枚の透明レイヤーに分解することもできます。出力は 1K、1.5K、2K、またはピクセル数を指定したサイズです。モデルの詳細と Playground。

Wan API に接続する見出しのリンクをコピー

API のベース URL は https://api.wanapi.app です。API キー設定で Wan モデルファミリーのキーを作成し、Authorization: Bearer YOUR_API_KEY として送信してください。キーはサーバー側で保管します。Playground はウェブサイトのログインセッションを使い、同じアカウントの残高から課金します。

GET /v1/models で、そのキーから利用できるモデルを取得できます。Seedream 5.0 Pro は OpenAI Images API を使用します。POST /v1/images/generations には JSON、POST /v1/images/edits には JSON または multipart によるファイルアップロードで送信します。画像の準備ができるとレスポンスが返るため、ポーリングするタスクはありません。

画像を生成する見出しのリンクをコピー

サーバー側で WAN_API_KEY に API キーを設定してください。リクエストは一度だけ送信します。通常は 1 分以内に生成が完了しますが、クライアントのタイムアウトは少なくとも 4 分に設定してください。

curl https://api.wanapi.app/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
  "size": "1K"
}'

レスポンスは OpenAI Images 形式です。以下の値は例示です。

{
  "created": 1792022400,
  "data": [
    {
      "url": "https://cdn.example.com/image-1.jpg",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}

画像 URL は 30 日間利用できます。それ以上必要な場合は、ご自身でファイルを保存してください。"response_format": "b64_json" を送信すると、各画像が Base64 形式でも b64_json に返されます。

Seedream 5.0 Pro の料金見出しのリンクをコピー

生成された画像は、ピクセル数に応じて 1 枚ごとに公式料金の 30% 引きで課金されます。261 万ピクセル以下の画像（1K と 1.5K）には低い単価、それより大きい画像には高い単価が適用されます。最初の参照画像は無料で、2 枚目以降は 1 枚ごとに参照画像の単価が加算されます。画像生成前に拒否されたリクエストには課金されません。

レイヤー分解では、ベース画像と返されたすべてのレイヤーに課金されます。すべての画像が 261 万ピクセル以下なら、各画像が公式レイヤー料金の 30% 引きになります。返された画像の一つでもそれより大きい場合は、すべての画像にそれぞれのサイズに応じた公式レイヤー単価が適用されます。2K では必ずこの条件に該当します。最大 17 枚分をまかなえる残高が必要ですが、実際に支払うのは返された画像の分だけです。

リクエストフィールド見出しのリンクをコピー

JSON オブジェクトを送信します。model は必須です。layer_decomposition が true の場合を除き、prompt も必須です。未定義のフィールドは受け付けません。

stream、sequential_image_generation、tools、seed、guidance_scale、mask は、このモデルでは対応していないため受け付けません。

参照画像を編集・合成する見出しのリンクをコピー

画像 1 枚と編集指示を指定するか、合成する複数の画像を渡します。

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
  "image": [
    "https://example.com/bottle.png",
    "https://example.com/table.jpg"
  ],
  "size": "2K",
  "output_format": "png"
}

POST /v1/images/edits は同じフィールドを受け付けます。multipart では、image または image[] フィールドにファイルをアップロードし、optimize_prompt_options は JSON 文字列で送信してください。

レイヤー分解見出しのリンクをコピー

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Separate the title text, the parrot and the background",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K"
}

レスポンスではベース画像が最初に並びます。各レイヤーには重ね順、位置、説明が追加されます。

{
  "created": 1792022400,
  "data": [
    { "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://cdn.example.com/image-2.png",
      "size": "1273x265",
      "output_format": "png",
      "z_index": 1,
      "bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
      "name": "Title text",
      "description": "Yellow serif title text"
    }
  ],
  "usage": { "input_images": 1, "generated_images": 2 }
}

一つでもレイヤーの生成に失敗すると、リクエスト全体が失敗します。プロンプトで上限を超える数のレイヤーを指定すると、一部のレイヤー内容が省かれる場合があります。

エラー見出しのリンクをコピー

エラーは OpenAI 形式の {"error": {"message", "type", "code"}} で返されます。

タイムアウト後は、利用ログを確認するまでリクエストを自動で再送信しないでください。