Video
PixVerse V6 Max
Tạo clip PixVerse V6 Max dài 1–15 giây từ prompt hoặc một ảnh, ở 360p đến 1080p với âm thanh tùy chọn, tính phí theo giây và giao kết quả qua tác vụ.
PixVerse V6 Max là phiên bản chi tiết hơn của PixVerse V6. Mô hình tạo clip 1–15 giây từ prompt, hoặc một ảnh khởi đầu với prompt không bắt buộc, ở 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
| ID mô hình | Đầu vào | Độ phân giải | Độ dài |
|---|---|---|---|
pixverse-v6-max | văn bản, một ảnh | 360p, 540p, 720p, 1080p | 1–15 giây |
Xem trang mô hình để biết giá hiện tại. Chuyển cảnh, tham chiếu nhiều ảnh và kéo dài là các tính năng của PixVerse V6.
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-max",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'Endpoint
POST https://api.seedrouter.ai/v1/videos/generations| Header | Giá trị |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
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ố
| Trường | Kiểu | Mặc định | Ghi chú |
|---|---|---|---|
model | string | bắt buộc | pixverse-v6-max |
prompt | string | xem ghi chú | Văn bản thành video: bắt buộc, tối đa 5.000 ký tự. Khi có ảnh: không bắt buộc, tối đa 2.048 ký tự. |
image_urls | danh sách URL | không có | Ảnh thành video: đúng một ảnh. Không có ảnh thì clip được tạo từ văn bản. |
resolution | enum | 540p | 360p, 540p, 720p hoặc 1080p. |
quality | enum | không có | Tên khác của resolution, cùng các giá trị. resolution được ưu tiên khi gửi cả hai. |
duration | integer | 5 | 1–15 giây. |
aspect_ratio | enum | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 hoặc 21:9. Chỉ dùng cho văn bản thành video; khi có ảnh, clip lấy theo tỷ lệ của ảnh. |
audio | boolean | false | Tạo âm thanh gốc. Tính theo mức giá có âm thanh. |
seed | integer | không có | 0–2147483647. Cùng yêu cầu và seed cho kết quả tương tự. |
Lược đồ là nghiêm ngặt: trường không xác định bị từ chối chứ không bị bỏ qua. first_frame_image, last_frame_image, img_references và extend_from_task_id trả về 400 với chỉ dẫn dùng pixverse-v6. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.
Ảnh thành video
Truyền một ảnh vào image_urls. Clip mở đầu bằng ảnh và giữ nguyên tỷ lệ của ảnh, nên ảnh dọc tạo ra clip dọc. Prompt ở đây không bắt buộc.
{
"model": "pixverse-v6-max",
"prompt": "The subject slowly turns toward the camera, soft natural light.",
"image_urls": ["https://example.com/start.png"],
"resolution": "1080p",
"duration": 5
}Đầ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, mỗi cạnh tối đa 10.000 pixel.
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 Max 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 settingVăn bản thành video và ảnh thành video có cùng giá. Độ 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-max", "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-max",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689690,
"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 81–89 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-max",
"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 ở
360phoặc540p, rồi render cảnh quay cuối cùng ở1080pvới cùng yêu cầu vàseed. - Để tạo video dọc, gửi
aspect_ratio: "9:16"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.
