Dùng Wan 2.7 Video qua Rivya Public API v1 với model id wan-2-7-video, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.

Khả dụng qua APIText hoặc URL sẵn sàng; reference modes dùng Files APIVideo

ID mô hình API

wan-2-7-video

Input

text, file

Files API

Bắt buộc cho reference modes

Tín dụng cơ bản

Năng lực

Video

Thanh toán

FIXED

Giới hạn prompt

5000 ký tự

Hợp đồng yêu cầu

Gửi model id ở top level. Điều khiển riêng của mô hình nằm trong params.

Key	Type	Bắt buộc	Default	Mô tả
model	string	Có	wan-2-7-video	Dùng API model id wan-2-7-video.
prompt	string	Có	-	Tối đa 5000 ký tự cho mô hình này.
params	object	Không	-	Object 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	-	Client-side id tùy chọn để trace request trong hệ thống của bạn.

Tham số mô hình

Key	Type	Bắt buộc	Default	Range	Options	Mô tả
resolution	select	Không	720p	-	720p, 1080p	Độ phân giải
duration	select	Không	5	-	5, 10, 15	Các lượt chạy từ văn bản và hình ảnh có thể dùng 5, 10 hoặc 15 giây. Chỉnh sửa video hiện tối đa là 10 giây, và Rivya tự động chuẩn hóa các lựa chọn dài hơn trong chế độ đó.
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Các lượt text-to-video và chỉnh sửa video dùng trực tiếp tham số này. Image-to-video hiện đi theo hình học của khung hình tải lên thay vì mở riêng một công tắc tỷ lệ khung hình.
negative_prompt	text	Không	-	-	-	Prompt âm
prompt_extend	select	Không	true	-	true, false	Kiểm soát việc mô hình có viết lại prompt của bạn trước khi tạo hay không. Bật để tiện hơn, hoặc tắt khi bạn đã có một prompt rất chính xác.
watermark	select	Không	false	-	false, true	Watermark
audio_setting	select	Không	auto	-	auto, origin	Kiểm soát cách xử lý âm thanh trong đường chỉnh sửa video. Auto để mô hình quyết định, còn Giữ nguyên cố gắng bảo toàn âm thanh của video nguồn.
seed	number	Không	-	min 0 / max 2147483647	-	Để 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

Upload reference files trước, 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 2 asset. Dùng tối đa 2 ảnh cho image-to-video, hoặc 1 video cộng 1 ảnh tùy chọn cho chỉnh sửa video.

Số file tối đa

Loại file đượ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 duration.

kind	Kích thước tối đa	MIME types
image	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime

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

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Các loại trừ hoặc lỗi hình ảnh tùy chọn cần tránh.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

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

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Các loại trừ hoặc lỗi hình ảnh tùy chọn cần tránh.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Phản hồi tạo

Create endpoint trả về public task id. Poll status endpoint cho đến khi task succeeded hoặc failed.

{
  "id": "task_wan_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "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ố mode cần Files API reference uploads.

Tích hợp API Wan 2.7 Video