接口地址
POST /v1/images/generations
支援模型
vidu-imageviduq3-fastviduq2-providuq2-fast
模型說明
請求參數
string
必填
只支援這 4 個模型名:
vidu-imageviduq3-fastviduq2-providuq2-fast
string
必填
文字提示詞
string[]
參考圖 URL,支援 0-7 張
integer
預設值:1
僅支援
1string
預設值:"1:1"
支援比例值,也支援像素值,例如
1024*1024支援的比例值:1:14:33:416:99:163:22:3
string
預設值:"1K"
當
size 傳比例值時可選解析度:1K2K4K
viduq2-fast 僅支援 1K。當 size 使用比例值且 metadata.resolution 為 2K 或 4K 時會直接報錯。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-image、viduq3-fast或viduq2-pro
說明
- Vidu 圖片渠道會先在上游建立任務,再輪詢上游任務狀態。
- 成功結果會鏡像到 ToAPIs 自有 R2,再返回統一圖片任務回應。
expires_at為completed_at + 24h。