Tài liệu Rivya AI
Trang API mô hình

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.

Khả dụng qua APIVăn bản hoặc URL đã sẵn sàng; chế độ tham chiếu dùng Files APIVideo
ID mô hình API

wan-2-6

Đầu vào

text, file

Files API

Bắt buộc cho chế độ tham chiếu

Tín dụng cơ bản

70

Năng lực

Video

Thanh toán

FIXED

Giới hạn prompt

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.

KeyLoạiBắt buộcMặc địnhMô tả
modelstringwan-2-6Dùng wan-2-6 làm ID mô hình API.
promptstring-Tối đa 5000 ký tự cho mô hình này.
paramsobjectKhô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_idstringKhô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

KeyLoạiBắt buộcMặc địnhPhạm viTùy chọnMô tả
resolutionselectKhông720p-720p, 1080pĐộ phân giải
durationselectKhông5-5, 10, 15Thờ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.

Quy tắc tham chiếu

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.

Số tệp tối đa

1

Loại tệp được chấp nhận

image, video

Token thời lượng

Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.

kindKích thước tối đaLoại MIME
image10 MBimage/jpeg, image/png, image/webp
video10 MBvideo/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.