Skip to main content
GET
  • 查詢異步圖片生成任務的執行狀態和結果
  • 實時狀態更新和進度跟蹤
  • 任務完成時獲取生成的圖片
  • 支持多語言返回(zh/en/ko/ja)
所有圖片生成任務都是異步執行的。提交任務後,您需要通過查詢接口獲取任務狀態和結果。

創建任務時傳入業務 ID

創建圖片任務時,可以在請求體頂層傳入 client_business_id。該字段用於保存您系統內的訂單號、流水號或業務任務 ID,方便後續按業務 ID 查詢生成結果。
也兼容放在 metadata.client_business_id 中,但推薦使用頂層字段。

Authorizations

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

Path Parameters

string
必填
圖片生成 API 返回的任務 ID。也可以傳創建任務時提交的 client_business_id,用於按客戶側業務 ID 查詢任務狀態和結果。
如果創建圖片任務時傳入 client_business_id,可直接使用同一個狀態查詢接口: GET /v1/images/generations/{client_business_id}。業務 ID 會限定在當前 API Key 所屬用戶下查詢。

Response

string
任務唯一標識符
string
客戶側業務 ID。僅當創建任務時傳入 client_business_id 時返回。
string
對象類型,固定爲 generation.task
string
使用的圖片生成模型
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務進度百分比(0-100)
integer
任務創建時間(Unix 時間戳)
integer
任務完成時間(Unix 時間戳,僅完成時返回)
integer
圖片 URL 過期時間(Unix 時間戳,僅完成時返回)
object
任務結果(僅成功時返回)
object
錯誤信息(僅失敗時返回)

任務狀態說明

輪詢策略建議

Python 輪詢示例

圖片資源有效期

生成的圖片 URL 有效期爲 24 小時
  • 請在有效期內下載保存圖片
  • expires_at 字段標識圖片過期時間(Unix 時間戳)
  • 圖片過期後無法訪問,如需重新獲取,需要重新提交生成任務

常見錯誤

ToAPIs 支持統一 任務 Webhook。回調為主、輪詢後備;至少 5~10 秒並加入抖動,429 讀取 Retry-After。批次最多 100 個任務,詳見 限流