APIMaster.ai

PixVerse V6.0 / C1 — 完整引數與計費

PixVerse V6.0 與 C1 的影片生成介面、引數及任務查詢。

PixVerse V6.0 / C1

使用 APIMaster API Key:Authorization: Bearer $APIMASTER_API_KEY,請求型別為 application/json。本頁完整路徑中的 /v1 已包含在 https://apimaster.ai/v1 中,例如 /v1/wand/... 對應 https://apimaster.ai/v1/wand/...。

閘道器先預留額度,確認實際用量後只結算一次,多餘預留額度返還。餘額不足時請求會在提交前拒絕。網路中斷後請保留 request_id,避免盲目重發生成請求。

模型:pixverse-video-v6.0、pixverse-video-c1。支援四個 POST 路徑,字首 /v1/wand/pixverse/:text-to-video、image-to-video、start-end-to-video、reference-to-video。查詢 GET /v1/wand/pixverse/tasks/{task_id}。Bearer 鑑權,JSON。

引數 型別 必填/範圍
model string 必填,以上兩個模型 ID
prompt string 四種路徑均必填,最多 5000 字元;參考生可用 @ref_name 引用素材
duration integer 必填,1–15 秒,預設值為 5,1080p 也支援到 15 秒
quality string 必填,360p / 540p / 720p / 1080p
aspect_ratio string 僅文生/參考生;16:9(預設)、4:3、1:1、3:4、9:16、2:3、3:2、21:9
seed integer 0–2,147,483,647;省略或 0 隨機
generate_audio_switch boolean 有聲 true,靜音 false(預設)
camera_movement string 僅文生/圖生;運鏡名稱,例如 zoom_in
generate_multi_clip_switch boolean 僅 V6.0 的文生/圖生;預設 false,C1/首尾幀/參考生均不支援
img_id string 圖生必填,公網圖片 URL 或 Base64;輸出按該圖比例
img_ids string[] 圖生的多圖模板專用;普通圖生不使用
first_frame_img string 首尾幀必填,首幀 URL 或 Base64
last_frame_img string 首尾幀必填,尾幀 URL 或 Base64;建議首尾比例一致
image_references object[] 參考生必填,最多 7 項;每項 img_id 必填,type 可為 subject/background,ref_name 最多 30 字元

圖生和首尾幀不能傳 aspect_ratio,畫幅跟隨輸入圖;這些圖片欄位直接接收 URL/編碼資料,不要求預上傳。當前請求不接受負向提示詞引數。

提交響應必須同時檢查 HTTP 與業務 ErrCode(0 成功);ErrMsg 為描述;任務 ID 位於 Resp.video_id。頂層 request_id 用於排錯。查詢以 Resp.status 為準:1 成功、5 生成中、6 已刪除、7 稽核失敗、8 生成失敗。建議每 3–5 秒輪詢。

查詢返回 Resp.id、status、url、prompt、negative_prompt、seed、style、resolution_ratio、outputWidth、outputHeight、size、create_time、modify_time。成功結果 Resp.url 是臨時連結,最長 12 小時,應儘快轉存。tokenhub_usage.total_tokens 是實際計費量。HTTP 200 仍可能有業務錯誤,不能當作生成成功。避免重複建立/重複結算;查詢需使用建立任務的賬戶。

任務提交與查詢

提交返回的是 APIMaster 公開任務 ID;查詢必須使用同一賬戶的有效 API Key,且該 Key 須有對應模型許可權。查詢不會重新生成。終態查詢可重複執行,不會重複扣款。提交可帶 Idempotency-Key(8–128 個可見 ASCII 字元);同一賬戶重複使用相同鍵和引數時返回 202 恢復憑據,不再次提交;同鍵不同引數返回 409。查詢恢復憑據使用通用影片冪等恢復介面,並按響應中的 task_id 查詢本頁任務路徑。callback_url 當前不支援,請輪詢。

價格

APIMaster 當前售價請檢視模型卡 pixverse-video-v6.0、pixverse-video-c1。