Gunakan Wan 3.0 Video melalui Rivya Public API v1 dengan id model wan-3-0-video, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIVideo

ID model API

wan-3-0-video

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

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⌉

Kapabilitas

Video

Tagihan

METERED

Batas prompt

20000 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	wan-3-0-video	Gunakan wan-3-0-video sebagai id model API.
prompt	string	Ya	-	Maksimum 20000 karakter untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
seedance_scene	select	Tidak	text	-	text, frames, reference	Pilih satu kontrak input eksklusif sebelum mengunggah media.
variant	select	Tidak	standard	-	standard, prime	Standard dan Prime memakai kontrol yang sama tetapi tarif per detik berbeda.
resolution	select	Tidak	1080P	-	480P, 720P, 1080P	Reservasi adalah tarif varian dan resolusi dikalikan detik video masukan terverifikasi ditambah detik keluaran yang dicadangkan, lalu total dibulatkan ke atas sekali. Durasi cerdas mencadangkan 30 detik keluaran dan tidak tersedia bersama video referensi.
aspect_ratio	select	Tidak	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Pilih pembingkaian adaptif atau satu rasio output tetap.
duration	number	Tidak	5	min -1 / max 30 / step 1	-	Pilih -1 untuk durasi cerdas atau bilangan bulat dari 2 hingga 30 detik. Durasi cerdas mencadangkan 30 detik output dan tidak dapat digunakan dengan video referensi.
audio	select	Tidak	true	-	true, false	Pilih apakah video yang dibuat harus menyertakan audio buatan model.
seed	number	Tidak	-	min 0 / max 2147483647 / step 1	-	Biarkan kosong untuk hasil acak baru setiap kali. Menggunakan ulang integer yang sama membuat hasil sebelumnya lebih mudah direproduksi atau disempurnakan. Hasil hanya akan lebih dekat bila prompt dan pengaturan kunci lain juga tetap mirip, dan ini bukan jaminan kecocokan 1:1.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Bingkai panduan atau referensi multimodal bertanda tangan: Bingkai menerima satu gambar pertama wajib dan satu gambar terakhir opsional. Referensi menerima hingga 10 gambar JPEG, PNG tanpa transparansi, WebP, atau BMP masing-masing 20 MB; 5 video MP4/MOV masing-masing 95 MB dan 1–15 detik; serta 5 klip audio MP3/WAV masing-masing 15 MB dan 1–15 detik. Total video dan audio masing-masing dibatasi 15 detik.

File maksimum

Jenis file yang diterima

image, video, audio

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kind	Ukuran maksimum	Tipe 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

Request minimal

{
  "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
  }
}

Request file referensi

{
  "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"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API Wan 3.0 Video