跳轉到主要內容
Seedream 5.5
Seedream 5.5 是字節跳動的圖像創作與編輯模型。使用 doubao-seedream-5-5-261028 呼叫文字生圖、參考圖編輯、透明背景生成及可編輯圖層拆分。 POST https://api.mixroute.ai/v1/images/generations 向圖片生成介面傳送 JSON,請求標頭為 Authorization: Bearer $MIXROUTE_API_KEY 和 Content-Type: application/json。參數直接放在頂層,不包進 metadata。參考圖編輯和圖層拆分也使用這個介面,不使用 /v1/images/edits 或 Chat Completions。
MixRoute 的所有請求都必須提供 prompt,圖層拆分也不例外。即使上游範例將其標為選填,也不能省略。

請求參數

圖片、尺寸與限制

  • 一般生成每次只回傳 1 張圖片,n 不控制輸出數量。不支援串流、組圖或連網搜尋,請省略 stream、sequential_image_generation 及搜尋工具欄位。
  • 單張參考圖不超過 30 MB,寬高比為 1:16 至 16:1。Base64 data URL 的格式名稱必須小寫,例如 data:image/png;base64,...。
  • 生成時使用解析度級別,可在 prompt 中描述寬高比;使用 寬x高 時用小寫 x,總像素須為 921,600-4,624,220,寬高比為 1:16 至 16:1,例如 2880x1440。像素限制指寬乘高,不是單邊長度。
  • 拆分只能輸入 1 張 PNG 或 JPEG,總像素不少於 262,144(512 x 512)。size: auto 依輸入尺寸與寬高比調整,不保證每個輸出都維持原始像素尺寸,請讀取各項 data[].size。
  • 任一圖層失敗,整個拆分請求失敗。提示詞要求的輸出數超過 max_images 時,部分要求拆出的元素可能缺失。

請求範例

將 MIXROUTE_API_KEY 設定為 MixRoute Key。傳送請求前,將下方 example.com 輸入網址替換為可存取的圖片。

文字生圖

多圖參考

透明 PNG

圖層拆分與 OCR

Python OpenAI SDK

安裝 openai 套件,設定 MIXROUTE_API_KEY 和 SEEDREAM_IMAGE_URL。Seedream 專有欄位及解析度值放在 SDK 的 extra_body 中;傳送時會合併為頂層 JSON 欄位,不會產生 extra_body 或 metadata 包裝物件。範例關閉自動重試,避免盲目重複生圖請求。

回傳欄位

以下為包含 1 張底圖和 1 個圖層的示意回應節錄:

還原圖層

以 z_index: 0 的底圖為畫布,依 bounding_box.absolute 將各圖層縮放到 (right - left) x (bottom - top),放置在 (left, top),再按 z_index 由小到大進行透明合成。圖層原生 size 可能與放置尺寸不同。OCR 提供文字資訊,實際文字編輯仍由你的應用程式完成。

計費

輸入圖和成功輸出圖分別按張計費。輸出級別依每張圖實際寬乘高決定,不只看請求中的尺寸名稱。以下美元標準價與目前公開報價一致,帳號及路由實際價格以模型廣場為準。
  • 每張參考圖或待拆分圖都算輸入圖。底圖和每個成功生成的圖層各算一張輸出圖,依各自像素級別計價;未成功輸出的圖不計費。
  • 圖層拆分會按 max_images 預扣額度,完成後依實際輸出張數結算,退回未使用的預扣部分。餘額有限時可調小該上限。
  • 例如:1 張輸入圖,成功輸出 3 張且每張均超過 2,610,000 像素,標準價為 0.0075 + 3 * 0.0345 = 0.111 美元。不同尺寸的圖層可能屬於不同價格級別,實際扣費請查看消費紀錄。

常見錯誤

模型介紹