Vidu Video Q4 Preview — 完整引數與計費
Vidu Video Q4 Preview 的圖生影片、參考生影片和任務查詢介面。
Vidu Video Q4 Preview
使用 APIMaster API Key:Authorization: Bearer $APIMASTER_API_KEY,請求型別為 application/json。本頁完整路徑中的 /v1 已包含在 https://apimaster.ai/v1 中,例如 /v1/wand/... 對應 https://apimaster.ai/v1/wand/...。
閘道器先預留額度,確認實際用量後只結算一次,多餘預留額度返還。餘額不足時請求會在提交前拒絕。網路中斷後請保留 request_id,避免盲目重發生成請求。
vidu-video-q4-preview 支援圖生與參考生影片,不支援純文生影片及首尾幀介面。介面路徑:圖生 POST /v1/wand/vidu/image-to-video;參考生 POST /v1/wand/vidu/reference-to-video;查詢 GET /v1/wand/vidu/tasks/{task_id}。Bearer 鑑權,JSON。
| 引數 | 型別 | 適用場景 | 說明 |
|---|---|---|---|
| model | string | 全部,必填 | vidu-video-q4-preview |
| images | string[] | 圖生必填;參考生與 subjects 二選一 | 圖生恰好 1 張;參考生最多 15 張。公網 URL 或 data URI;png/jpeg/jpg/webp,寬高比須在 1:4–4:1 內;URL 單圖最多 50MB;Base64 原始圖片總量最多 15MB,編碼後最多 20MB |
| subjects | object[] | 參考生,與 images 二選一 | 每項 name 為主體名稱/ID,images 為 1–3 張主體圖,提示詞用 @name 引用;影象限制同上 |
| prompt | string | 圖生可選;參考生必填 | 圖生/主體參考不超過 5000 字元,直接 images 參考不超過 2000 字元;圖生開啟 is_rec 時忽略手寫 prompt |
| auto_subjects | boolean | 參考生 | 智慧主體庫開關,預設 false |
| audio | boolean | 兩種 | 圖生預設 true;Q4 參考生預設 false,要有聲須顯式 true,且使用 subjects 方式 |
| audio_type | string | audio=true 時 | all(預設)、speech_only、sound_effect_only |
| is_rec | boolean | 圖生 | 自動推薦提示詞,開啟會增加任務用量 |
| duration | integer | 兩種 | 3–16 秒,預設 5 |
| resolution | string | 兩種 | 540p、720p(預設)、1080p、2K、4K |
| aspect_ratio | string | 僅參考生 | 16:9(預設)、9:16、3:4、4:3、1:1;圖生按輸入圖比例 |
| seed | integer | 兩種 | 省略或 0 為隨機 |
| payload | string | 兩種 | 業務透傳,最多 1,048,576 字元 |
| watermark | boolean | 兩種 | 預設 false |
| wm_url | string | 兩種 | 自定義水印圖片 URL;省略使用預設水印 |
| wm_position | integer | 不支援 | 不接受。預設水印位於左上角 |
提交返回 task_id、state、model、prompt、images、duration、audio、seed、resolution、credits、created_at、request_id;欄位按場景返回。查詢還含 creations[].url、creations[].cover_url、tokenhub_usage.total_tokens。狀態 created / queueing / processing / success / failed;每 5–10 秒輪詢。URL 有效期 12 小時,成功後及時下載。credits 不代表美元費用,請檢視響應中的計費量和最終賬單。
餘額、許可權、輸入圖片下載/格式、內容稽核、任務不存在、併發限流及內部失敗均應作為不同錯誤處理;任務成功只結算一次,失敗終態按預扣退款規則處理。不要因查詢超時重新提交任務。
任務提交與查詢
提交返回的是 APIMaster 公開任務 ID;查詢必須使用同一賬戶的有效 API Key,且該 Key 須有對應模型許可權。查詢不會重新生成。終態查詢可重複執行,不會重複扣款。提交可帶 Idempotency-Key(8–128 個可見 ASCII 字元);同一賬戶重複使用相同鍵和引數時返回 202 恢復憑據,不再次提交;同鍵不同引數返回 409。查詢恢復憑據使用通用影片冪等恢復介面,並按響應中的 task_id 查詢本頁任務路徑。callback_url 當前不支援,請輪詢。
價格
APIMaster 當前售價請檢視模型卡 vidu-video-q4-preview。
