Skip to main content
POST
Image Editing / Multi-image Fusion / Batch Sequence
1つのエンドポイント、複数のモード: Seedream には個別の /v1/images/edits エンドポイントはありません。編集、複数画像の融合、バッチシーケンスはすべて POST /v1/images/generations で行われます。このページのプレイグラウンドは テキストから画像生成 と同じエンドポイントを呼び出します — 唯一の違いは、リクエスト本文内の imagesequential_image_generation パラメータです。
モード:
  • 単一画像の編集image: ["url"] + sequential_image_generation: "disabled"
  • 複数画像の融合image: ["url1", "url2", ...] + disabled
  • バッチシーケンスsequential_image_generation: "auto" + sequential_image_generation_options.max_images: N
  • 画像からシーケンス — 2 つを組み合わせます: image 配列 + auto + max_images
🖥️ ブラウザ版 Playground の制限(b64_json モードのみ)デフォルトの response_format: "url" モードでは、Playground は問題なく動作します(レスポンスは一時的な BytePlus TOS リンクだけです)。response_format: "b64_json" に切り替えると、レスポンスに数 MB の base64 文字列が含まれ、ブラウザ版 Playground では 请求时发生错误: unable to complete request と表示されることがあります — リクエスト自体は実際には成功しています。ブラウザがそのような長い base64 文字列をレンダリングできないだけです。推奨ワークフロー:
  • 画像を表示したいだけですか? デフォルトの url モードのままにしてください — Playground はリンクを直接返します(24 時間以内にご自身のストレージへダウンロードしてください)。
  • b64_json が必要ですか? 下のコードサンプルをコピーしてローカルで実行してください — コードが画像をデコードしてファイルに自動保存します。
⚠️ OpenAI gpt-image-2 の編集との主な違い
  • multipart/form-data アップロードは不要です — まず画像を OSS か公開画像ホストにアップロードし、その後 image 配列に URL を渡します
  • image は URL 配列であり、繰り返しの image[] フィールドではありません(OpenAI の multipart/form-data 形式とは異なります)
  • mask フィールドはありません — Seedream はアルファチャンネルマスクのインペインティングをサポートしておらず、画像全体が prompt によって書き換えられます
  • 合計数には厳しい上限があります: 入力参照 + 出力 ≤ 15 枚の画像
📎 複数画像では順序が重要ですimage 配列内の URL の順序が、prompt で参照される「画像 1 / 画像 2 / 画像 3」になります。順序を明示してください:
画像 1 の服を画像 2 の衣装に置き換え、画像 3 の照明は維持してください。
英語の prompt が最も効果的です(モデルは主に英語で学習されています)が、表現が明確であれば中国語もサポートされています。

コード例

extra_body について(重要 — 追加のネスト層だと誤解しないでください)imagesequential_image_generation、および watermark は、OpenAI SDK の images.generate() の標準パラメータではないため、Python SDK では送信するには extra_body の中に入れる 必要がありますしかし、extra_body は単なる SDK のパラメータコンテナであり、そのフィールドはリクエストボディの 最上位にフラット化されてマージされmodelprompt同じ階層 に置かれます。実際に送信される JSON は下の cURL 例と同じで、(image は最上位にあります);リクエスト内に本当の "extra_body": {...} ネストは ありませんOpenAI SDK を使わずに JSON を直接組み立てる場合(requests / fetch / など)は、extra_body と書かないでくださいimage と他のフィールドを model と同じ階層に置くだけです。

Python (OpenAI SDK · 単一画像編集)

Python (OpenAI SDK · 複数画像融合)

Python (OpenAI SDK · バッチシーケンス)

cURL (複数画像融合)

Node.js (fetch · バッチシーケンス)

パラメータリファレンス

複数画像およびシーケンスモードにおけるカウント制約

反復的な精緻化: 以前の出力の URL を次の入力として、新しい編集指示を与え、段階的に精緻化します。各ラウンドは画像ごとに課金されます。累積コストに注意してください。

応答形式

⚠️ data 配列の長さは実際の出力数を反映します
  • sequential_image_generation: "disabled" → 単一要素の data
  • sequential_image_generation: "auto" + max_images: N → 通常は N 要素(prompt の生成結果が少ない場合は、さらに少なくなることがあります)
  • 課金は usage.generated_images 単位で、max_images 単位ではありません
編集リクエストは text-to-image と同様に、出力画像ごとに課金されます。参照画像の入力は別途課金されません。

承認

Authorization
string
header
必須

API Key obtained from APIYI Console

ボディ

application/json
model
enum<string>
デフォルト:seedream-5-0-260128
必須

Model ID

利用可能なオプション:
seedream-5-0-260128,
seedream-5-0-lite-260128,
seedream-4-5-251128,
seedream-4-0-250828,
seedream-5-0-pro-260628
prompt
string
必須

Editing / fusion / sequence instruction. For multi-image scenarios, refer to images explicitly as 'image 1 / image 2'

:

"Replace the clothing in image 1 with the outfit from image 2."

image
string<uri>[]

Reference image URL array. Up to 10 images (per official 4.5 docs). Note: input + output count ≤ 15

Maximum array length: 10
:
sequential_image_generation
enum<string>
デフォルト:disabled

Generation mode switch. disabled = single output (default); auto = batch sequence, paired with max_images

利用可能なオプション:
disabled,
auto
sequential_image_generation_options
object

Batch sequence options. Effective only when sequential_image_generation=auto

size
string
デフォルト:2K

Output size. Preset tiers (vary by version):

  • 1K (4.0 only) / 2K (all) / 3K (5.0 only) / 4K (4.5, 4.0)

Or exact pixel size WxH, total pixels ∈ [1280×720, 4096×4096], aspect ratio ∈ [1/16, 16]

:

"2K"

response_format
enum<string>
デフォルト:url
利用可能なオプション:
url,
b64_json
output_format
enum<string>
デフォルト:jpeg

Output format. 5.0 supports png/jpeg; 4.5/4.0 only jpeg

利用可能なオプション:
png,
jpeg
watermark
boolean
デフォルト:false
stream
boolean
デフォルト:false

Streaming output. Recommended for long prompts and multi-image sequence scenarios

レスポンス

Edited image generated successfully

model
string
:

"seedream-5-0-260128"

created
integer
:

1768518000

data
object[]

Result array. disabled mode returns 1 element; auto mode typically returns max_images elements (may be fewer)

usage
object

Billed by generated_images actual count, NOT by max_images