Gunakan Wan 2.7 Video melalui Rivya Public API v1 dengan ID model wan-2-7-video, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIVideo

ID model API

wan-2-7-video

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

Keupayaan

Video

Bil

FIXED

Had prompt

5000 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	wan-2-7-video	Gunakan ID model API wan-2-7-video.
prompt	string	Ya	-	Maksimum 5000 aksara untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
resolution	select	Tidak	720p	-	720p, 1080p	Resolusi
duration	select	Tidak	5	-	5, 10, 15	Percubaan teks dan imej boleh menggunakan 5, 10, atau 15 saat. Penyuntingan video pada masa ini berhenti pada 10 saat, dan Rivya menormalkan pilihan yang lebih panjang secara automatik dalam mod itu.
aspect_ratio	select	Tidak	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4	Percubaan teks-ke-video dan penyuntingan video menggunakan ini secara langsung. Imej-ke-video pada masa ini mengikut geometri bingkai yang dimuat naik dan tidak mendedahkan suis nisbah aspek berasingan.
negative_prompt	text	Tidak	-	-	-	Prompt negatif
prompt_extend	select	Tidak	true	-	true, false	Mengawal sama ada model menulis semula prompt anda sebelum penjanaan. Kekalkan hidup untuk kemudahan, atau matikan apabila anda sudah mempunyai prompt yang sangat tepat.
watermark	select	Tidak	false	-	false, true	Tera air
audio_setting	select	Tidak	auto	-	auto, origin	Mengawal cara audio dikendalikan dalam laluan suntingan video. Auto membiarkan model membuat keputusan, manakala Kekalkan asal cuba mengekalkan audio video sumber.
seed	number	Tidak	-	min 0 / max 2147483647	-	Biarkan kosong untuk hasil rawak baharu setiap kali. Menggunakan semula nombor bulat yang sama memudahkan anda menghasilkan semula atau memperhalus hasil sebelumnya. Hasil hanya kekal lebih hampir apabila prompt dan tetapan utama lain juga masih serupa, dan ia bukan padanan 1:1 yang dijamin.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Media rujukan: Muat naik sehingga 2 aset. Gunakan sehingga 2 imej untuk imej-ke-video, atau 1 video bersama 1 imej pilihan untuk penyuntingan video.

Fail maksimum

Jenis fail diterima

image, video

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	20 MB	image/jpeg, image/png, image/webp
video	95 MB	video/mp4, video/quicktime

Permintaan minimum

{
  "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 pilihan atau mod kegagalan yang mahu dielakkan.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Permintaan fail rujukan

{
  "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 pilihan atau mod kegagalan yang mahu dielakkan.",
    "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"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Poll endpoint status sehingga tugasan berjaya 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
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Wan 2.7 Video