APIMaster.ai

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。