Skip to main content
POST
图片编辑 / 多图融合 / 批量序列
同端點,不同模式:Seedream 沒有獨立的 /v1/images/edits 端點,編輯 / 多圖融合 / 批次序列都走 POST /v1/images/generations。本頁 Playground 與 文生圖頁 調的是同一個端點,區別只在請求體的 imagesequential_image_generation 引數。
場景說明
  • 單圖編輯 —— image: ["url"] + sequential_image_generation: "disabled"
  • 多圖融合 —— image: ["url1", "url2", ...] + sequential_image_generation: "disabled"
  • 批次序列生成 —— sequential_image_generation: "auto" + sequential_image_generation_options.max_images: N
  • 圖生序列 —— 上面兩個組合:傳 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 / 公網圖床拿到 URL,再放進 image 陣列
  • image 是 URL 陣列不是 image[] 欄位重複(與 OpenAI gpt-image-2multipart/form-data 格式完全不同)
  • 沒有 mask 欄位 —— Seedream 不支援 alpha 通道掩碼局部重繪,整圖 prompt 改寫
  • 總張數硬約束:輸入參考圖 + 輸出圖 ≤ 15 張
📎 多圖融合順序有意義image 陣列的順序會作為 prompt 中「圖1/圖2/圖3」的引用依據。建議在 prompt 中顯式指代:
Replace the clothing in image 1 with the outfit from image 2, keeping the lighting from image 3.
推薦 prompt 用英文(官方訓練以英文為主),中文也可用但表達不要含糊。

程式碼示例

關於 extra_body(重要,別被「套一層」誤導)imagesequential_image_generationwatermark 不是 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 作為下一次的 image 輸入,配合新的編輯指令逐步精調。每一輪都按張計費,預算時留意累計成本。

響應格式

⚠️ data 陣列長度反映實際輸出張數
  • sequential_image_generation: "disabled"data 單元素
  • sequential_image_generation: "auto" + max_images: Ndata 通常 N 個元素(個別 prompt 模型可能輸出少於 N)
  • 計費按 usage.generated_images 實際張數算,不是按 max_images
編輯請求和文生圖請求計費完全一致——按出圖張數算。多圖輸入(參考圖)不額外計費。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
model
enum<string>
預設值:seedream-5-0-260128
必填

模型 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
必填

编辑 / 融合 / 序列指令。多图场景建议用「图1/图2」明确指代顺序

範例:

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

image
string<uri>[]

参考图 URL 数组。最多 10 张(4.5 官方明确)。注意输入 + 输出张数总和 ≤ 15

Maximum array length: 10
範例:
sequential_image_generation
enum<string>
預設值:disabled

图像生成模式开关。disabled = 单图输出(默认);auto = 批量序列输出,配合 max_images 指定张数

可用選項:
disabled,
auto
sequential_image_generation_options
object

批量序列生成选项,仅 sequential_image_generation=auto 时生效

size
string
預設值:2K

输出尺寸。预设档位(各版本支持不同):

  • 1K(仅 4.0)/ 2K(全版本)/ 3K(仅 5.0)/ 4K(4.5、4.0)

或精确像素 WxH,总像素 ∈ [1280×720, 4096×4096],宽高比 ∈ [1/16, 16]

範例:

"2K"

response_format
enum<string>
預設值:url
可用選項:
url,
b64_json
output_format
enum<string>
預設值:jpeg

输出格式。5.0 支持 png / jpeg;4.5 / 4.0 仅 jpeg

可用選項:
png,
jpeg
watermark
boolean
預設值:false
stream
boolean
預設值:false

流式输出。长 prompt 或多图序列场景建议开启

回應

成功生成编辑后图片

model
string
範例:

"seedream-5-0-260128"

created
integer
範例:

1768518000

data
object[]

生成结果数组。disabled 模式 1 个元素,auto 模式通常 max_images 个元素(实际可能少于)

usage
object

按 generated_images 实际张数计费,不是按 max_images