Seedream 5.5

使用模型 doubao-seedream-5-5-261028 搭配 POST https://apimaster.ai/v1/images/generations、JSON 請求主體與 Authorization: Bearer YOUR_API_KEY。請在主控台建立您的 APIMaster 金鑰。

支援文字生圖、最多十張參考圖的編輯、連續編輯、原生透明 RGBA 輸出、圖層分解與富文字 OCR。一般生成會回傳一張圖片。分解會回傳一個基底與多個獨立圖層。不支援串流、序列圖片生成與網路搜尋。 請使用同步端點；用戶端逾時前至少預留 300 秒，並避免盲目重新提交。

官方基礎定價

已於 2026-11-13 核對 Volcengine 定價。配置採用的換算匯率為 1 USD = 7 CNY。

項目	每張圖片 CNY	約略美元基礎價格
每張輸入參考圖，包括第一張	0.05	0.00714286
寬 × 高 ≤ 2,610,000 像素的輸出	0.13	0.01857143
超過 2,610,000 像素的輸出	0.23	0.03285714

生成與分解使用相同的輸出費率。請依每個基底/圖層的實際 data[].size 分別計費；最長邊不會決定計費級距。2048x1024 屬於較低級距。兩張輸入加一張高級距輸出的費用為 CNY 0.33，尚未套用帳戶/頻道乘數。與 Seedream 5.0 Pro 不同，第一張參考圖並非免費。實際帳戶費用包含適用的頻道/使用者群組係數與整數配額捨入。請參閱即時模型卡與用量記錄。

文字生圖

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

參數

欄位	類型 / 預設值	規則
model	必填字串	doubao-seedream-5-5-261028。
prompt	字串	生成時必填；分解時選填。描述內容、風格、長寬比、文字或編輯位置。官方撰寫指引建議 ≤300 個中文字或 ≤600 個英文單字；這是指引，並非位元組限制。
image	字串或字串[]	公開 URL 或 data:image/png;base64,...。生成最多十張參考圖；分解時必須恰好一個輸入。本機檔案系統路徑無法使用。
size	字串	生成預設為 2K；1K、1.5K、2K 或精確的 WIDTHxHEIGHT。分解預設為 auto，僅接受 auto 與這三個級距。
output_format	字串，png	png 或 jpeg。分解時僅控制基底；圖層一律為 PNG。
background	字串，auto	auto、transparent 或 opaque，僅用於生成。透明輸出需要 PNG；分解時請完全省略此欄位。
response_format	字串，url	url 或 b64_json。請讀取每個 data[] 項目中的對應欄位。
watermark	布林值，true	設為 false 以省略可見的 AI 生成浮水印。
optimize_prompt_options	物件	只有 {"mode":"standard"} 受到 5.5 支援；fast 不受支援。
layer_decomposition	布林值，false	啟用單一 PNG/JPEG 圖片的分解。
layer_decomposition_options	物件	下方的分解選項。
layer_decomposition_options.max_images	整數，30	2–100，包含基底。此為上限，並非保證數量。
layer_decomposition_options.text_recognition	布林值，false	要求對一般文字圖層進行富文字 OCR。
safety_identifier	字串	穩定的英文使用者識別碼，最多 64 個字元；請使用雜湊值，而非個人聯絡資訊。

請勿使用其他模型的 resolution、quality、n 或 seed 來控制此模型。官方 API 並未將這些列為其對應的生成控制項。請使用 layer_decomposition_options.max_images 設定分解限制。

尺寸與輸入限制

一般生成時，請選擇級距（1K、1.5K、2K）並在提示詞中描述長寬比，或提供精確尺寸。精確輸出面積必須為 921,600–4,624,220 像素，長寬比為 1:16–16:1，且須同時滿足這兩項限制。2880x1440 有效；512x512 太小。沒有 4K 級距。

分解不接受精確尺寸。使用 auto 時，落在支援範圍內的基底/圖層尺寸會盡可能保留原始尺寸；較小/較大的項目會朝 1K/2K 縮放，同時保留其長寬比。回傳的圖層可能落在不同的計費級距。

輸入限制	生成/編輯	分解
數量	最多 10	恰好 1
格式	JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF	PNG、JPEG
每張圖片檔案大小	≤30 MB	≤30 MB
像素面積	196–36,000,000；兩邊 >14 px	262,144–36,000,000
長寬比	1:16–16:1	1:16–16:1

在 data URL 中使用小寫 MIME 類型。遠端輸入 URL 必須可供服務存取。

編輯與透明圖片

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

只有一個輸入時，image 可以是字串。進行連續編輯時，請明確將先前的輸出作為下一個輸入傳入：這不是有狀態的對話，且每個請求會分別計費。請在提示詞中描述座標/方框/箭頭，或在參考圖上繪製標記；此介面沒有另外記載的 mask 定位參數。

若要原生透明生成，請在不需要時省略 image，並設定 background: "transparent"、output_format: "png"，搭配例如「a translucent blue glass butterfly, isolated asset, transparent background」的提示詞。編輯最多可使用十張參考圖；這些參考圖不需要已有 alpha 通道。transparent 加上 jpeg 無效。回應中的 background 會描述實際透明度（transparent 或 opaque）。

分解與富文字 OCR

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

支援 一個基底加上最多 99 個圖層。max_images: 4 包含基底。請省略 background；每個圖層都是透明 PNG。個別圖層失敗會使整個請求失敗，而不會回傳部分成功。

請讀取所有 data[] 項目：

• url/b64_json、size 與 output_format 可識別產物及其實際尺寸；background 會在適用時提供。
• z_index: 0 可識別基底；較大的索引會顯示在較小的索引上方。
• name 與 description 會描述圖層。
• bounding_box.absolute 是 [left,top,right,bottom]，單位為輸出基底像素。請將圖層調整為 (right-left) × (bottom-top)，並放置在 (left,top)；圖層檔案尺寸可能與其在畫布上的佔用範圍不同。
• bounding_box.normalized 使用 0–1000 座標。將水平/垂直座標乘以目標畫布寬度/高度，再除以 1000.。
• text_recognition 僅在要求時出現，且該圖層包含可辨識的一般文字。手寫文字、藝術字與非文字圖層可能省略此欄位。

OCR 包含 text 與 lines[]；每一行都有各自的 bounding_box 與帶樣式的 runs[]。每個文字片段都有 text 與 style，其中可包含 similar_font_family、foreground_color（#RRGGBB）、bold、italic、underline、strikethrough、shadow 與 translucent。這些是近似的視覺判讀，並非原始設計的精確屬性；字型辨識可能回傳 unknown。

回應、儲存與失敗

回應包含 created、model、data[]、usage.input_images 與 usage.generated_images。生成的數量包含基底與圖層。請保留完整的回應中繼資料。原始供應商下載 URL 會在 24 小時後過期；請及時下載/封存您的資產。

重試前，請先修正無效的尺寸、參考圖數量或不相容的透明度選項。請分別處理驗證、權限、內容審核、速率限制與上游失敗；切勿將錯誤解讀為生成成功。IPM 限制會按帳戶/模型版本計算生成的圖片數量；分解會預留 max_images，並在完成後歸還未使用的容量，而計費則採用實際產生的圖片。

官方來源：Seedream 5.5、圖片生成 API、定價。參數核對日期：2026-11-13。