Dùng Wan 3.0 Video qua Rivya Public API v1 với ID mô hình wan-3-0-video, đầ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-3-0-video

Đầu vào

text, file

Files API

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

Tín dụng cơ bản

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

Năng lực

Video

Thanh toán

METERED

Giới hạn prompt

20000 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-3-0-video	Dùng wan-3-0-video làm ID mô hình API.
prompt	string	Có	-	Tối đa 20000 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ả
seedance_scene	select	Không	text	-	text, frames, reference	Chọn một hợp đồng đầu vào loại trừ lẫn nhau trước khi tải nội dung lên.
variant	select	Không	standard	-	standard, prime	Standard và Prime dùng cùng điều khiển nhưng có mức giá mỗi giây khác nhau.
resolution	select	Không	1080P	-	480P, 720P, 1080P	Khoản giữ chỗ bằng đơn giá theo phiên bản và độ phân giải nhân với tổng số giây video đầu vào đã xác minh và số giây đầu ra được giữ chỗ, sau đó chỉ làm tròn lên một lần. Thời lượng thông minh giữ chỗ 30 giây đầu ra và không dùng được với video tham chiếu.
aspect_ratio	select	Không	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Chọn bố cục thích ứng hoặc một tỷ lệ đầu ra cố định.
duration	number	Không	5	min -1 / max 30 / step 1	-	Chọn -1 cho thời lượng thông minh hoặc số nguyên từ 2 đến 30 giây. Thời lượng thông minh giữ trước 30 giây đầu ra và không thể dùng với video tham chiếu.
audio	select	Không	true	-	true, false	Chọn xem video tạo ra có bao gồm âm thanh do mô hình tạo hay không.
seed	number	Không	-	min 0 / max 2147483647 / step 1	-	Để trống để mỗi lần nhận một kết quả ngẫu nhiên mới. Dùng lại cùng một số nguyên sẽ giúp dễ tái tạo hoặc tinh chỉnh kết quả trước đó hơn. Kết quả chỉ gần hơn khi prompt và các thiết lập quan trọng khác cũng tương tự, và không đảm bảo khớp 1:1.

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

Khung hình hướng dẫn hoặc tham chiếu đa phương thức có chữ ký: Cảnh Khung hình nhận một hình ảnh đầu bắt buộc và một hình ảnh cuối tùy chọn. Cảnh Tham chiếu nhận tối đa 10 hình ảnh JPEG, PNG không trong suốt, WebP hoặc BMP, mỗi hình 20 MB; 5 video MP4/MOV, mỗi video 95 MB và 1–15 giây; cùng 5 clip âm thanh MP3/WAV, mỗi clip 15 MB và 1–15 giây. Tổng thời lượng video và âm thanh đều được giới hạn riêng ở 15 giây.

Số tệp tối đa

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

image, video, audio

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.

kind	Kích thước tối đa	Loại MIME
image	20 MB	image/jpeg, image/png, image/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Yêu cầu tối thiểu

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

Yêu cầu có tệp tham chiếu

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

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_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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.

Tích hợp API Wan 3.0 Video