ToAPIsToAPIs
Seedream-5.5

Seedream-5.5 圖像生成

使用 Seedream 5.5 生成及編輯圖像, 支援 1K/1.5K/2K, 透明 PNG 與圖層拆分

POST
/v1/images/generations

中國大陸用戶請注意: 中國大陸用戶請使用 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_KEY

Body

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"
      }
    ]
  }
}