Gunakan Wan 2.7 Video melalui Rivya Public API v1 dengan id model wan-2-7-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-2-7-video

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

Kapabilitas

Video

Tagihan

FIXED

Batas prompt

5000 karakter

Kontrak request

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

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	wan-2-7-video	Gunakan wan-2-7-video sebagai id model API.
prompt	string	Ya	-	Maksimum 5000 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
resolution	select	Tidak	720p	-	720p, 1080p	Resolusi
duration	select	Tidak	5	-	5, 10, 15	Proses teks dan gambar dapat memakai 5, 10, atau 15 detik. Penyuntingan video saat ini dibatasi di 10 detik, dan Rivya menormalkan pilihan yang lebih panjang secara otomatis dalam mode itu.
aspect_ratio	select	Tidak	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Proses teks-ke-video dan penyuntingan video memakai ini secara langsung. Gambar-ke-video saat ini mengikuti geometri bingkai yang diunggah, bukan membuka sakelar rasio aspek terpisah.
negative_prompt	text	Tidak	-	-	-	Prompt negatif
prompt_extend	select	Tidak	true	-	true, false	Mengontrol apakah model menulis ulang prompt Anda sebelum generasi. Biarkan aktif untuk kemudahan, atau nonaktifkan saat Anda sudah memiliki prompt yang sangat presisi.
watermark	select	Tidak	false	-	false, true	Watermark
audio_setting	select	Tidak	auto	-	auto, origin	Mengontrol cara audio ditangani di jalur penyuntingan video. Otomatis membiarkan model memutuskan, sementara Pertahankan asli mencoba mempertahankan audio video sumber.
seed	number	Tidak	-	min 0 / max 2147483647	-	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

Media referensi: Unggah hingga 2 aset. Gunakan hingga 2 gambar untuk gambar-ke-video, atau 1 video plus 1 gambar opsional untuk penyuntingan video.

File maksimum

Jenis file yang diterima

image, video

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/webp
video	95 MB	video/mp4, video/quicktime

Request minimal

{
  "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": "Pengecualian atau mode kegagalan opsional yang perlu dihindari.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Request file referensi

{
  "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": "Pengecualian atau mode kegagalan opsional yang perlu dihindari.",
    "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"
      }
    ]
  }
}

Response create

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

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

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API Wan 2.7 Video