Skip to main content
POST
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。
  • Seedream 5.0 Pro 高質量圖像生成模型,由字節跳動 Seed 團隊研發
  • 通過 model 參數選擇 doubao-seedream-5-0-pro 模型
  • 參數與 Seedream-5.0 基本一致,差異在於 Pro 支持 1K 和 2K 分辨率
  • 支持文生圖、圖生圖、多圖參考等生成模式
  • 計費規則:首張參考圖免費,從第 2 張參考圖開始按正常規則計費
  • 異步任務管理,通過任務 ID 查詢結果
重要變更:爲了更好的性能和成本控制,我們不再支持在 image_urls 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。

Authorizations

string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加:

Body

string
預設值:"doubao-seedream-5-0-pro"
必填
圖像生成模型名稱示例:"doubao-seedream-5-0-pro"
string
必填
圖像生成的文本描述
string
預設值:"1:1"
圖像寬高比啟用 layer_decomposition 時,該欄位改為直接傳入分辨率預設 1K 或 2K。支持的寬高比:
  • 1:1 - 正方形(默認)
  • 4:3 - 橫向 4:3
  • 3:4 - 豎向 3:4
  • 16:9 - 橫向寬屏
  • 9:16 - 豎向長圖
  • 3:2 - 橫向 3:2
  • 2:3 - 豎向 2:3
  • 21:9 - 超寬屏
  • 9:21 - 超窄屏
integer
預設值:1
生成圖像的數量範圍:1-10(最少 1 張,最多 10 張)默認:1注意:
  • 參考圖像 + 生成圖像總數必須 ≤ 15
  • 必須輸入純數字(如 1),不要加引號,否則會報錯
會根據生成數量和參考圖數量進行預扣費,其中首張參考圖免費
boolean
預設值:false
是否啟用 Seedream 5.0 Pro 專屬的圖層拆分能力。
  • false:返回一般的扁平圖像(預設)
  • true:返回底圖和多個帶透明通道的獨立 PNG 圖層
啟用後,每個 result.data[] 項目會返回 z_index;獨立圖層還會返回 bounding_box、name 和 description。此參數僅支援 Seedream 5.0 Pro。
string[]
參考圖像 URL 列表,用於圖生圖或圖像編輯⚠️ 僅支持 URL 格式(不再支持 base64)
  • 公開可訪問的圖像 URL(http:// 或 https://)
  • 可使用 上傳圖片接口 上傳本地圖片獲取 URL
限制:
  • 圖片數量:1-10 張
  • 圖像格式:jpeg, png
  • 寬高比(寬/高)範圍:[1/3, 3]
  • 寬度和高度(px)> 14
  • 大小:不超過 10MB
  • 總像素:不超過 6000×6000 px
計費說明:
  • 首張參考圖免費
  • 從第 2 張參考圖開始按正常規則計費
object
渠道特有參數,用於傳遞 Seedream 5.0 Pro 模型的高級配置

Response

string
任務唯一標識符,用於查詢任務狀態
string
對象類型,固定爲 generation.task
string
使用的模型名稱
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務進度百分比(0-100)
integer
任務創建時間戳(Unix 時間戳)
object
任務元數據
integer
任務完成時間戳(Unix 時間戳)。僅在任務完成後返回。
integer
結果檔案的過期時間戳(Unix 時間戳)。請在過期前下載或轉存結果檔案。
object
任務成功後的生成結果。僅當 status 為 completed 時返回。
string
結果類型,圖片任務固定為 image。
array
圖片結果列表。啟用圖層拆分時,第一個元素通常為底圖,其餘元素為帶透明通道的獨立 PNG 圖層。
string
底圖或獨立圖層的公開存取網址。
integer
圖層疊放順序。啟用圖層拆分時,底圖通常為 0,獨立圖層依次遞增。
string
當前底圖或獨立圖層的像素尺寸,例如 2048x2048。
string
當前結果項目的檔案格式。底圖可使用請求的格式,透明獨立圖層則為 png。
object
獨立圖層在底圖中的位置,包含 absolute 絕對座標和 normalized 正規化座標。
array
圖層在底圖中的絕對像素座標,格式為 [x1, y1, x2, y2],分別表示左上角和右下角座標。
array
圖層的正規化座標,格式為 [x1, y1, x2, y2],座標範圍為 0-1000。
string
圖層名稱。
string
圖層內容描述。