Seedream-5.5 圖像生成 | ToAPIs Documentation

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請求體預設值: 2K

支援 1K, 1.5K, 2K 預設, 或 WIDTHxHEIGHT 像素尺寸, 例如 2048x2048. 預設代表解析度級別, 不固定輸出長寬比. 指定尺寸的總像素範圍為 921600-4624220. 固定正方形請使用 2048x2048, 不要直接傳 1:1. 一般生圖省略時使用 2K; 圖層拆分建議明確傳入 2K.

image_urlsstring[]請求體

參考圖像 URL 清單, 用於圖像編輯或多圖參考.

最多 10 張參考圖.
僅支援可公開存取的 HTTP/HTTPS URL, 不支援直接傳入 base64 資料.
本機圖片請先透過上傳圖片介面上傳並取得 URL.
也可使用 reference_images 或 images 陣列欄位.

imagestring請求體

單張參考圖的 URL 字串. 多張參考圖請使用 image_urls, 不要將陣列放入 image.

layer_decompositionboolean請求體

設為 true 時拆分唯一一張參考圖. 可省略 prompt; 請省略組圖參數. 回傳底圖及多個透明 PNG 圖層, 包含 z_index, 圖層定位資訊和名稱. 目前介面最多處理 1 個底圖及 16 個圖層, 未提供圖層數量或 OCR 設定.

optimize_prompt_optionsobject請求體

提示詞最佳化選項, 使用 {"mode": "standard"}. Seedream 5.5 不接受 fast.

metadataobject請求體

渠道特有參數, 用於傳遞 Seedream 5.5 模型的高級配置

metadata 屬性

metadata.output_formatstring請求體預設值: png

輸出格式為 png 或 jpeg. 需要透明背景時請使用 png.

metadata.backgroundstring請求體

可傳 opaque 或 transparent. 透明背景不能與 output_format=jpeg 同時使用; 設定 transparent 且省略格式時使用 PNG. 目前介面不接受明確的 auto 值.

metadata.watermarkboolean請求體預設值: false

是否加入可見的 AI generated 浮水印. false 關閉可見浮水印, true 開啟. 此選項不代表移除來源中繼資料或隱形標記.

metadata.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

任務狀態

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.

執行範例前設定 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,
  "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"
      }
    ]
  }
}