Vidu Image Q2 — 完整引數與計費
Vidu Image Q2 的文生圖和參考生圖介面、請求引數及任務查詢。
Vidu Image Q2
使用 APIMaster API Key:Authorization: Bearer $APIMASTER_API_KEY,請求型別為 application/json。本頁完整路徑中的 /v1 已包含在 https://apimaster.ai/v1 中,例如 /v1/wand/... 對應 https://apimaster.ai/v1/wand/...。
閘道器先預留額度,確認實際用量後只結算一次,多餘預留額度返還。餘額不足時請求會在提交前拒絕。網路中斷後請保留 request_id,避免盲目重發生成請求。
提交:POST /v1/wand/vidu-image/generation;查詢:GET /v1/wand/vidu-image/tasks/{task_id}。均使用 Bearer API Key。JSON 請求,非同步生成。
| 引數 | 型別 | 必填 | 說明 |
|---|---|---|---|
| model | string | 是 | vidu-image-q2 |
| prompt | string | 是 | 不超過 2000 字元;無參考圖時為文生圖 |
| images | string[] | 否 | 0–7 張 URL 或 data URI 圖片;png/jpeg/jpg/webp;至少 128×128;寬高比在 1:4–4:1 以內;單圖不超過 50MB;整個請求不超過 20MB |
| aspect_ratio | string | 否 | 16:9(預設)、9:16、1:1、3:4、4:3、21:9、2:3、3:2、auto;auto 跟隨第一張參考圖 |
| resolution | string | 否 | 1080p(預設)、2K、4K,大小寫按此傳遞 |
| seed | integer | 否 | 省略或 0 為隨機 |
| callback_url | string | 否 | APIMaster 當前不接受此欄位,請使用任務查詢介面輪詢 |
提交響應含 task_id、state、prompt、created_at、request_id。state 依次可能為 created、queueing、processing,最終 success 或 failed。成功提交後只輪詢,不重複建立。建議每 3–5 秒查詢,查詢請使用建立任務的賬戶。
查詢響應包含 state、model、aspect_ratio、resolution、creations、request_id、tokenhub_usage。成功圖片位於 creations[].url,臨時 URL 有效期 12 小時。tokenhub_usage.total_tokens 是計費量;任務查詢本身不可重複收取生成費用。
異常分類:缺參/非法欄位(BadRequest、FieldLacking、FieldInvalid、FieldUnwanted);圖片數量/尺寸/格式及下載失敗;內容稽核(TaskPromptPolicyViolation、CreationPolicyViolation、AuditSubmitIllegal);許可權(Unauthorized、Forbidden);餘額(CreditInsufficient);併發/限流(QuotaExceeded、TooManyRequests);TaskNotFound;InternalServiceFailure。失敗應保留 request_id,按任務終態處理預扣退款。
任務提交與查詢
提交返回的是 APIMaster 公開任務 ID;查詢必須使用同一賬戶的有效 API Key,且該 Key 須有對應模型許可權。查詢不會重新生成。終態查詢可重複執行,不會重複扣款。提交可帶 Idempotency-Key(8–128 個可見 ASCII 字元);同一賬戶重複使用相同鍵和引數時返回 202 恢復憑據,不再次提交;同鍵不同引數返回 409。查詢恢復憑據使用通用影片冪等恢復介面,並按響應中的 task_id 查詢本頁任務路徑。callback_url 當前不支援,請輪詢。
價格
APIMaster 當前售價請檢視模型卡 vidu-image-q2。
