Tích hợp API Wan 2.6
Dùng Wan 2.6 qua Rivya Public API v1 với ID mô hình wan-2-6, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.
wan-2-6
text, file
Bắt buộc cho chế độ tham chiếu
70
Video
FIXED
5000 ký tự
Quy ước yêu cầu
Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.
| Key | Loại | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
| model | string | Có | wan-2-6 | Dùng wan-2-6 làm ID mô hình API. |
| prompt | string | Có | - | Tối đa 5000 ký tự cho mô hình này. |
| params | object | Không | - | Đối tượng tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép. |
| client_request_id | string | Không | - | ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn. |
Tham số mô hình
| Key | Loại | Bắt buộc | Mặc định | Phạm vi | Tùy chọn | Mô tả |
|---|---|---|---|---|---|---|
| resolution | select | Không | 720p | - | 720p, 1080p | Độ phân giải |
| duration | select | Không | 5 | - | 5, 10, 15 | Thời lượng |
Chính sách tải lên
Trước tiên tải tệp tham chiếu lên, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.
Media tham chiếu: Tải lên tối đa 1 tệp hình ảnh / video cho dự án hình ảnh / video.
1
image, video
Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.
| kind | Kích thước tối đa | Loại MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
| video | 10 MB | video/mp4, video/quicktime, video/x-matroska |
Yêu cầu tối thiểu
{
"model": "wan-2-6",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5"
}
}Yêu cầu có tệp tham chiếu
{
"model": "wan-2-6",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Phản hồi tạo
Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.
{
"id": "task_wan_2_6_example",
"status": "queued",
"model": "wan-2-6",
"reserved_credits": 70,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Lỗi thường gặp
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Một số chế độ cần tải tệp tham chiếu qua Files API.