Gunakan Wan 3.0 Video melalui Rivya Public API v1 dengan ID model wan-3-0-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-3-0-video

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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⌉

Keupayaan

Video

Bil

METERED

Had prompt

20000 aksara

Kontrak permintaan

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

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	wan-3-0-video	Gunakan ID model API wan-3-0-video.
prompt	string	Ya	-	Maksimum 20000 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
seedance_scene	select	Tidak	text	-	text, frames, reference	Pilih satu kontrak input eksklusif sebelum memuat naik media.
variant	select	Tidak	standard	-	standard, prime	Standard dan Prime menggunakan kawalan yang sama tetapi kadar per saat yang berbeza.
resolution	select	Tidak	1080P	-	480P, 720P, 1080P	Tempahan ialah kadar varian dan resolusi didarab dengan jumlah saat video input yang disahkan dan saat output yang ditempah, kemudian jumlah dibundarkan ke atas sekali. Tempoh pintar menempah 30 saat output dan tidak tersedia bersama video rujukan.
aspect_ratio	select	Tidak	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Pilih pembingkaian adaptif atau satu nisbah output tetap.
duration	number	Tidak	5	min -1 / max 30 / step 1	-	Pilih -1 untuk tempoh pintar atau nombor bulat dari 2 hingga 30 saat. Tempoh pintar menempah 30 saat output dan tidak boleh digunakan dengan video rujukan.
audio	select	Tidak	true	-	true, false	Pilih sama ada video yang dijana perlu menyertakan audio ciptaan model.
seed	number	Tidak	-	min 0 / max 2147483647 / step 1	-	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

Bingkai panduan atau rujukan multimodal bertandatangan: Adegan bingkai menerima satu imej pertama yang diperlukan dan satu imej terakhir secara pilihan. Adegan rujukan menerima sehingga 10 imej JPEG, PNG tanpa ketelusan, WebP atau BMP pada 20 MB setiap satu, 5 video MP4/MOV pada 95 MB dan 1–15 saat setiap satu, serta 5 klip audio MP3/WAV pada 15 MB dan 1–15 saat setiap satu; jumlah video dan audio masing-masing dihadkan secara berasingan kepada 15 saat.

Fail maksimum

Jenis fail diterima

image, video, audio

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/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

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

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Wan 3.0 Video