APIMaster.ai

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。