Skip to main content

接口地址

POST /v1/images/generations

支援模型

  • vidu-image
  • viduq3-fast
  • viduq2-pro
  • viduq2-fast

模型說明

請求參數

string
必填
只支援這 4 個模型名:
  • vidu-image
  • viduq3-fast
  • viduq2-pro
  • viduq2-fast
string
必填
文字提示詞
string[]
參考圖 URL,支援 0-7 張
integer
預設值:1
僅支援 1
string
預設值:"1:1"
支援比例值,也支援像素值,例如 1024*1024支援的比例值:
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
string
預設值:"1K"
size 傳比例值時可選解析度:
  • 1K
  • 2K
  • 4K
viduq2-fast 僅支援 1K。當 size 使用比例值且 metadata.resolution2K4K 時會直接報錯。
integer
隨機種子
boolean
預設值:false
是否加浮水印

請求示例

提交成功回應

如果請求中帶了 client_business_id,回應頂層也會帶出該欄位。

查詢任務

GET /v1/images/generations/{task_id}

處理中

成功

失敗

計費與行為說明

  • 這 4 個模型都走統一圖片非同步任務接口:POST /v1/images/generations
  • 回傳值中的 object 固定為 generation.task
  • 結果完成後透過 result.data[].url 返回圖片地址
  • viduq2-fast 是輕量規格,只保留 1K
  • 如需更高解析度,優先使用 vidu-imageviduq3-fastviduq2-pro

說明

  • Vidu 圖片渠道會先在上游建立任務,再輪詢上游任務狀態。
  • 成功結果會鏡像到 ToAPIs 自有 R2,再返回統一圖片任務回應。
  • expires_atcompleted_at + 24h