PixVerse V6

用 PixVerse V6 從文字、圖片、首尾影格、參考圖片或先前生成的影片生成 1–15 秒影片，360p 到 1080p，按秒計費。

PixVerse V6 是 PixVerse 的影片模型。一個模型 ID 涵蓋五種模式：文字轉影片、圖片轉影片、首尾影格轉場、多圖參考，以及延長你已生成的影片。模式由你傳送的欄位決定。影片長度為 1–15 秒，解析度為 360p、540p、720p 或 1080p，可選原生音訊。傳送請求，保存回傳的任務 ID，再從該任務讀取生成完成的影片。圖片以 URL 形式傳入。

模型 ID

模型 ID	輸入	解析度	時長
`pixverse-v6`	文字、一張圖片、首影格 + 尾影格、1–7 張參考圖片、一個已完成的 `pixverse-v6` 任務	`360p`、`540p`、`720p`、`1080p`	1–15 秒

目前價格請查看模型頁面。要從文字或一張圖片生成細節更豐富的單鏡頭影片，請看 PixVerse V6 Max。

快速範例

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "540p",
    "duration": 5,
    "size": "16:9"
  }'

端點

POST https://api.seedrouter.ai/v1/videos/generations

請求標頭	值
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

回應是一個任務（{"id": "task_...", "status": "processing"}），而不是生成完成的影片。請輪詢 GET /v1/tasks/{task_id} 取得結果。請把 API 金鑰保存在伺服器端程式碼中。

參數

欄位	類型	預設值	說明
`model`	string	必填	`pixverse-v6`
`prompt`	string	必填	最多 5,000 個字元。所有模式都必填。
`resolution`	enum	`540p`	`360p`、`540p`、`720p` 或 `1080p`。
`duration`	integer	`5`	1–15 秒。首尾影格轉場僅支援 `5` 或 `8` 秒。
`size`	enum	`16:9`	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2` 或 `21:9`。用於文字轉影片和多圖參考；其他模式採用圖片的畫面比例。
`audio`	boolean	`false`	生成原生音訊。依含音訊費率計費。
`seed`	integer	無	0–2147483647。同一個請求和種子會得到相似的結果。
`negative_prompt`	string	無	描述影片中不要出現的內容。最多 2,048 個字元。
`watermark`	boolean	`false`	加上浮水印。
`motion_mode`	enum	`normal`	僅支援 `normal`。
`generate_multi_clip_switch`	boolean	`false`	多片段生成。僅限文字轉影片和圖片轉影片。
`image_urls`	URL 清單	無	圖片轉影片。使用第一張圖片。
`first_frame_image`	URL	無	轉場：首影格。與 `last_frame_image` 一起傳送。
`last_frame_image`	URL	無	轉場：尾影格。與 `first_frame_image` 一起傳送。
`img_references`	URL 清單	無	多圖參考：1–7 張圖片。
`extend_from_task_id`	string	無	延長：你自己已完成的某個 `pixverse-v6` 任務的 ID。

請求結構採嚴格驗證：未知欄位會被拒絕，而不是被忽略。不支援 callback_url；請改為輪詢任務。

模式

模式由你傳送的欄位決定。每次請求只傳送一種模式的欄位。

模式	傳送欄位	說明
文字轉影片	不含圖片或延長欄位	`size` 設定畫面比例。
圖片轉影片	`image_urls`	影片以第一張圖片開頭。
轉場	`first_frame_image` + `last_frame_image`	5 或 8 秒。
多圖參考	`img_references`（1–7 個 URL）	組合圖片中的人物、物件或場景；`size` 設定畫面比例。
延長	`extend_from_task_id`	延續你自己已完成的一個 `pixverse-v6` 任務。

{
  "model": "pixverse-v6",
  "prompt": "The puppy slowly turns into a kitten, soft studio light.",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/kitten.jpg",
  "duration": 5
}

{
  "model": "pixverse-v6",
  "prompt": "The paper boat drifts on toward a lily pad.",
  "extend_from_task_id": "task_...",
  "resolution": "540p",
  "duration": 5
}

延長影片會回傳原影片及新增片段，只依新增片段的 duration 計費。在我們的測試中，將一段 1 秒影片延長 1 秒後，回傳的影片長度為 2.1 秒，按 1 秒計費。

媒體輸入

圖片是公開的 HTTP(S) URL。不接受 Base64 data URI：請把檔案上傳到你自己的儲存空間，再傳入它的 URL。請使用不超過 20 MB 的 JPG、PNG 或 WebP 圖片。

計費維度

目前費率請查看模型定價部分。PixVerse V6 按影片秒數計費，費率由解析度和是否生成音訊決定：

cost = duration × rate per second for the resolution and audio setting

所有模式的每秒費用相同；延長影片只對新增片段計費。時長在請求受理時就已確定，因此預扣金額就是實際扣款金額。最終扣款請在帳戶的用量紀錄中查看。失敗的任務不計費。

輸出結構

提交後回傳任務：

{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}

查詢任務

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每 10–20 秒輪詢一次，直到 status 變為 completed 或 failed。輪詢過程中出現網路逾時，並不代表生成失敗：請保留任務 ID 並繼續查詢。不要為了查看進度而再建立一個任務。

完成的任務

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689640,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

在我們的測試中，1 秒的 360p、16:9 影片回傳為 640 × 360 的 MP4（H.264），從提交到完成耗時 36–45 秒。

錯誤

在任務建立之前就被拒絕的請求，會回傳 HTTP 錯誤狀態碼和一個 error 物件，且不計費。受理之後才失敗的任務，在查詢時回傳 HTTP 200，並帶有 status: "failed" 和一個 error 物件。

錯誤碼、HTTP 狀態碼和重試建議請參閱共用錯誤目錄。

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

如果提交本身逾時，請先檢查你的任務清單再重新提交：第一次請求有可能已經被受理。

實用建議

在提示詞中描述主體、地點、運鏡和光線；開啟 audio 時，請寫明想要的聲音。
先用 360p 或 540p 做草稿，再用同一個請求和 seed 以 1080p 算繪最終鏡頭。
要生成直式影片，請在使用文字轉影片時傳入 size: "9:16"，或使用一張直式圖片。
加上 no text, no logos，避免出現憑空編造的標記。