快速结论
- 使用 model=doubao-seedream-5-5 调用异步图片任务接口.
- size 支持 1K/1.5K/2K 档位或显式宽高像素, 总像素 921600-4624220.
- metadata.background=transparent 輸出 RGBA PNG; 圖層拆分的總輸出上限含底圖, max_images 可設 2 到 100, 預設 30.
关键参数
- model | string | 必填 | doubao-seedream-5-5 | - | 固定使用 doubao-seedream-5-5 作为模型标识.
- prompt | string | 可选 | - | - | 一般生圖和改圖必填; layer_decomposition=true 時可省略.
- size | string | 可选 | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | 一般生圖採用模型預設解析度, 分層省略時為 auto. 級別不固定比例, 指定尺寸總像素 921600-4624220.
- image_urls | string[] | 可选 | - | 0-10 | 透過 image_urls 提供 1 到 10 張 JPEG, PNG 或 WEBP 參考圖. 本機檔案需先上傳, 再使用回傳的 URL.
- n | integer | 可选 | 1 | 1 | 僅支援 1 或省略. 一般生圖輸出 1 張, 此欄位不是分層圖層數量.
- layer_decomposition | boolean | 可选 | false | - | 一般生圖關閉. 開啟時必須恰好一張參考圖並省略 metadata.background. 回傳底圖和透明 PNG 圖層, 總輸出上限由 layer_decomposition_options.max_images 控制.
- layer_decomposition_options.max_images | integer | 可选 | 30 | 2-100 | 分層模式的總輸出上限, 包含底圖, 不是保證生成的固定張數. 實際數量由模型決定.
- layer_decomposition_options.text_recognition | boolean | 可选 | - | - | 控制圖層拆分的文字辨識. 僅在上游回傳時, 任務結果才包含 text_recognition 中繼資料.
- metadata.output_format | string | 可选 | - | png | jpeg | 未指定時沿用上游預設格式, 透明背景自動為 png. 分層時僅控制底圖, 其他圖層一律為 PNG.
- metadata.background | string | 可选 | - | auto | opaque | transparent | 僅一般生圖和改圖使用. layer_decomposition=true 時必須省略, opaque 也不支援. transparent 輸出 RGBA PNG, 不可配 jpeg.
- metadata.watermark | boolean | 可选 | - | - | 设为 false 关闭可见水印.
- metadata.response_format | string | 可选 | url | url | b64_json | 结果返回形式; 推荐使用 url.
常见错误
- 400 invalid_input: 触发=size 像素超出范围, 参考图超过 10 张, 或 layer_decomposition 未恰好传一张输入图.; 修复=按文档校验 size, image_urls 数量与 layer_decomposition 的输入约束.; 重试=修正参数后重试, 不建议盲重试.
- 429 rate_limit_exceeded: 触发=请求频率, 并发或额度命中限流策略.; 修复=先做指数退避重试, 再检查请求节奏与额度使用.; 重试=建议 1s/2s/4s 退避并加入抖动.










