Seedream-5.5 圖像生成
使用 Seedream 5.5 生成及編輯圖像, 支援 1K/1.5K/2K, 透明 PNG 與圖層拆分
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址 (Base URL).文檔示例中的 https://toapis.com 請替換為 https://toapis.cn.
透過 doubao-seedream-5-5 提交文字生圖, 參考圖編輯或圖層拆分工作. 介面先回傳工作 ID, 再透過工作查詢取得結果.
一般生圖回傳一張結果圖, 圖層拆分回傳底圖和圖層.
Authorizations
Authorizationstring請求頭必填所有接口均需要使用 Bearer Token 進行認證
獲取 API Key: 訪問 API Key 管理頁面 獲取您的 API Key
使用時在請求頭中添加:
Authorization: Bearer YOUR_API_KEYBody
modelstring請求體必填預設值: doubao-seedream-5-5圖像生成模型名稱
示例: "doubao-seedream-5-5"
promptstring請求體一般生圖與編輯必填的文字描述. 啟用 layer_decomposition 時可省略, 讓模型自動辨識要拆分的元素.
sizestring請求體支援 1K, 1.5K, 2K 解析度級別, 或 2048x2048 等指定像素尺寸. 級別不固定長寬比; 一般生圖的指定尺寸總像素範圍為 921600-4624220. 一般生圖採用模型預設解析度 (未設定時為 2K); 圖層拆分省略尺寸時為 auto. 本頁範例明確使用 2K, 不代表分層預設值.
圖層拆分僅支援 auto, 1K, 1.5K, 2K, 不接受指定像素尺寸, 並保持原圖比例. 一般生圖的指定尺寸長寬比須在 1/16 到 16 之間.
ninteger請求體預設值: 1僅支援 1 或省略, 表示一般生圖輸出 1 張圖片. 此參數不是分層圖層數量; 分層時也應省略或使用 1.
image_urlsstring[]請求體參考圖像 URL 清單, 用於圖像編輯或多圖參考.
- 最多 10 張參考圖.
- 僅支援可公開存取的 HTTP/HTTPS URL, 不支援直接傳入 base64 資料.
- 本機圖片請先透過 上傳圖片介面 上傳並取得 URL.
- 也可使用
reference_images或images陣列欄位. - 每張參考圖最大 30 MB. 圖層拆分的參考圖僅支援 JPEG 或 PNG.
imagestring請求體單張參考圖的 URL 字串. 多張參考圖請使用 image_urls, 不要將陣列放入 image.
layer_decompositionboolean請求體預設值: false一般文生圖和圖生圖應省略此參數或設為 false. 開啟後未提供參考圖, 或提供多張參考圖, 都屬於無效請求.
設為 true 時拆分唯一一張參考圖. 可省略 prompt; 請省略組圖參數. 回傳底圖及多個透明 PNG 圖層, 包含 z_index, 圖層定位資訊和名稱.
layer_decomposition_optionsobject請求體僅在 layer_decomposition=true 時使用. max_images 為 2 到 100 的整數, 限制包含底圖在內的輸出總數, 預設 30. 實際回傳數量由模型決定, 可能少於此上限. text_recognition 為布林值, 預設 false. 整個物件也可放在 metadata.layer_decomposition_options 中.
optimize_prompt_optionsobject請求體提示詞最佳化選項, 使用 {"mode": "standard"}. Seedream 5.5 不接受 fast.
metadataobject請求體渠道特有參數, 用於傳遞 Seedream 5.5 模型的高級配置
metadata 屬性
output_formatstring請求體預設值: png支援 png 或 jpeg, 預設為 png. 透明背景必須使用 PNG, 不支援 JPEG. 分層模式僅控制底圖格式, 其他圖層一律為透明 PNG.
backgroundstring請求體圖層拆分模式 (layer_decomposition=true) 必須完全省略 background, 即使值為 opaque 也不支援. 此參數僅用於一般生圖和圖像編輯.
可傳 auto, opaque 或 transparent. 透明背景不能與 output_format=jpeg 同時使用; 設定 transparent 且省略格式時使用 PNG.
一般生圖省略時預設為 auto, 由模型結合提示詞與輸出格式決定是否透明. JPEG 輸出一律不透明.
watermarkboolean請求體預設值: false是否加入可見的 AI generated 浮水印. false 關閉可見浮水印, true 開啟. 此選項不代表移除來源中繼資料或隱形標記.
response_formatstring請求體預設值: url本頁使用 url 模式. 圖片透過非同步工作查詢結果中的 URL 交付.
參數限制
不支援一般組圖. 請省略 sequential_image_generation 與 sequential_image_generation_options, 即使值為 disabled 也會被上游拒絕. 不支援 stream=true; 可省略 stream 或使用 false. 目前介面不支援 tools 網路搜尋參數及 seed.
查詢工作
提交成功不代表生成完成. 使用相同的 API Key 查詢工作. 狀態可能為 pending, queued, in_progress, completed 或 failed. 完成後讀取 result.data; 失敗時讀取 error.
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"Response
idstring任務唯一標識符, 用於查詢任務狀態
objectstring對象類型, 固定爲 generation.task
modelstring使用的模型名稱
statusstring任務狀態
pending,queued- 排隊等待處理in_progress- 處理中completed- 成功完成failed- 失敗
progressinteger任務進度百分比(0-100)
created_atinteger任務創建時間戳(Unix 時間戳)
metadataobject任務元數據
result.dataarray完成後的圖片清單. 一般生圖為一項, 圖層拆分為多項.
result.data[]object圖片 URL, 實際像素尺寸與輸出格式.
result.data[].z_indexinteger圖層的堆疊順序. 0 為底圖; 其餘圖層還可回傳 bounding_box, name, description.
result.data[].backgroundstring上游提供時回傳實際背景類型: opaque 或 transparent. 圖層拆分的底圖為 opaque, 其餘圖層為 transparent. 舊工作或其他未提供此資訊的模型會省略此欄位.
result.data[].text_recognitionobject上游提供時才會在對應圖層回傳文字辨識結果. 開啟 text_recognition 後, 回應仍可能省略此欄位.
物件包含全文 text 與逐行資訊 lines. 每行包含 bounding_box 與 runs; runs[].style 保留上游回傳的字型, 顏色及其他樣式資訊.
執行範例前設定 TOAPIS_API_KEY 環境變數. 參考圖範例中的 example.com 是預留位址, 請替換為可存取的圖片 URL.
請求示例
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"prompt": "A red toy sailboat and a small yellow sun, isolated objects, no text.",
"size": "2K",
"metadata": {
"output_format": "png",
"background": "transparent",
"watermark": false,
"response_format": "url"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"prompt": "Combine the subjects from both references into one product illustration.",
"size": "2K",
"image_urls": [
"https://example.com/reference-front.png",
"https://example.com/reference-side.jpg"
],
"metadata": {
"output_format": "png",
"watermark": false,
"response_format": "url"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"image": "https://example.com/composition.png",
"layer_decomposition": true,
"layer_decomposition_options": {"max_images": 30, "text_recognition": true},
"size": "2K",
"metadata": {
"output_format": "png",
"watermark": false,
"response_format": "url"
}
}'響應示例
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "doubao-seedream-5-5",
"status": "pending",
"progress": 0,
"created_at": 1794300000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "doubao-seedream-5-5",
"status": "completed",
"progress": 100,
"created_at": 1794300000,
"metadata": {},
"result": {
"type": "image",
"data": [
{
"url": "https://files.toapis.com/images/example/seedream-5-5.png",
"size": "2512x1680",
"output_format": "png"
}
]
}
}