PixVerse V6

PixVerse V6 là mô hình video của PixVerse. Một ID mô hình bao gồm năm chế độ: văn bản thành video, ảnh thành video, chuyển cảnh giữa khung hình đầu và cuối, tham chiếu nhiều ảnh và kéo dài clip bạn đã tạo. Chế độ được xác định theo các trường bạn gửi. Clip dài 1–15 giây ở 360p, 540p, 720p hoặc 1080p, với âm thanh gốc tùy chọn. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc video hoàn chỉnh từ tác vụ. Ảnh được truyền vào dưới dạng URL.

ID mô hình

Xem trang mô hình để biết giá hiện tại. Để tạo một cảnh quay chi tiết hơn từ văn bản hoặc một ảnh, hãy xem PixVerse V6 Max.

Ví dụ nhanh

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"
  }'

Endpoint

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

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải video hoàn chỉnh. Hãy truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Hãy giữ khóa API trong code phía máy chủ.

Tham số

Lược đồ là nghiêm ngặt: trường không xác định bị từ chối chứ không bị bỏ qua. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.

Chế độ

Các trường bạn gửi quyết định chế độ. Mỗi yêu cầu chỉ gửi các trường của một chế độ.

{
  "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
}

Kéo dài trả về clip nguồn nối với đoạn mới, và chỉ tính phí theo duration của đoạn mới. Trong thử nghiệm của chúng tôi, kéo dài thêm 1 giây cho clip 1 giây trả về video dài 2,1 giây và được tính phí 1 giây.

Đầu vào media

Ảnh là URL HTTP(S) công khai. Không chấp nhận data URI base64: hãy tải tệp lên kho lưu trữ của bạn và truyền URL của nó. Dùng ảnh JPG, PNG hoặc WebP tối đa 20 MB.

Các yếu tố chi phí

Xem phần giá của mô hình để biết mức giá hiện tại. PixVerse V6 tính phí theo từng giây video, với mức giá tùy độ phân giải và việc có tạo âm thanh hay không:

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

Mọi chế độ có cùng giá mỗi giây; kéo dài chỉ tính phí đoạn mới. Độ dài được biết ngay khi yêu cầu được tiếp nhận, nên số tiền tạm giữ chính là số tiền bị tính. Xem khoản phí cuối cùng trong lịch sử sử dụng của tài khoản. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Khi gửi, API trả về tác vụ:

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

Lấy thông tin tác vụ

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

Hãy truy vấn 10–20 giây một lần cho đến khi status là completed hoặc failed. Hết thời gian mạng trong lúc truy vấn không có nghĩa là việc tạo video đã thất bại: hãy giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ khác chỉ để xem tiến độ.

Tác vụ hoàn tất

{
  "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"
  }
}

Trong thử nghiệm của chúng tôi, clip 360p 16:9 dài 1 giây trả về dạng MP4 (H.264) ở 640 × 360, sau khi gửi 36–45 giây.

Lỗi

Những yêu cầu bị từ chối trước khi tác vụ được tạo sẽ trả về lỗi HTTP kèm đối tượng error và không bị tính phí. Tác vụ thất bại sau khi đã được tiếp nhận sẽ trả về HTTP 200 khi truy vấn, kèm status: "failed" và một đối tượng error.

Hãy xem danh mục lỗi dùng chung để biết mã lỗi, mã trạng thái HTTP và hướng dẫn thử lại.

{
  "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."
  }
}

Nếu chính lần gửi bị hết thời gian chờ, hãy kiểm tra các tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được tiếp nhận.

Mẹo

• Mô tả chủ thể, địa điểm, chuyển động máy quay và ánh sáng trong prompt; nêu âm thanh bạn muốn khi bật audio.
• Làm bản nháp ở 360p hoặc 540p, rồi render cảnh quay cuối cùng ở 1080p với cùng yêu cầu và seed.
• Để tạo video dọc, gửi size: "9:16" khi dùng văn bản thành video, hoặc một ảnh dọc.
• Thêm no text, no logos để tránh các dấu hiệu tự bịa ra.

Liên quan

• PixVerse V6 Playground và bảng giá
• Tài liệu API PixVerse V6 Max
• Tải OpenAPI
• Markdown có thể sao chép