Käytä mallia Wan 3.0 Video Rivya Public API v1:n kautta malli-ID:llä wan-3-0-video; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTeksti tai URL valmis; referenssimoodit käyttävät Files API:aVideo

API-malli-ID

wan-3-0-video

Syötteet

text, file

Files API

Vaaditaan referenssimoodeissa

Peruskrediitit

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⌉

Kyvykkyys

Video

Laskutus

METERED

Prompt-raja

20000 merkkiä

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

Avain	Tyyppi	Pakollinen	Oletus	Kuvaus
model	string	Kyllä	wan-3-0-video	Käytä wan-3-0-video-arvoa API-malli-ID:nä.
prompt	string	Kyllä	-	Enintään 20000 merkkiä tälle mallille.
params	object	Ei	-	Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_id	string	Ei	-	Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

Avain	Tyyppi	Pakollinen	Oletus	Alue	Vaihtoehdot	Kuvaus
seedance_scene	select	Ei	text	-	text, frames, reference	Valitse yksi toisensa poissulkeva syötesopimus ennen median lataamista.
variant	select	Ei	standard	-	standard, prime	Standard ja Prime käyttävät samoja säätimiä mutta eri sekuntihintoja.
resolution	select	Ei	1080P	-	480P, 720P, 1080P	Varaus on variantin ja tarkkuuden hinta kerrottuna vahvistettujen syötevideosekuntien ja varattujen tulostesekuntien summalla; loppusumma pyöristetään kerran ylöspäin. Älykäs kesto varaa 30 tulostesekuntia, eikä sitä voi käyttää viitevideon kanssa.
aspect_ratio	select	Ei	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Valitse mukautuva rajaus tai yksi kiinteä tuloksen kuvasuhde.
duration	number	Ei	5	min -1 / max 30 / step 1	-	Valitse -1 älykkäälle kestolle tai kokonaisluku 2–30 sekuntia. Älykäs kesto varaa 30 tulossekuntia, eikä sitä voi käyttää viitevideon kanssa.
audio	select	Ei	true	-	true, false	Valitse, sisältääkö generoitu video mallin luomaa ääntä.
seed	number	Ei	-	min 0 / max 2147483647 / step 1	-	Jätä tyhjäksi, jos haluat joka kerta uuden satunnaisen tuloksen. Saman kokonaisluvun käyttäminen uudelleen helpottaa aiemman tuloksen toistamista tai hienosäätöä. Tulos pysyy lähempänä vain silloin, kun kehote ja muut keskeiset asetukset ovat myös samankaltaisia, eikä se takaa täsmälleen samaa lopputulosta.

Latauskäytäntö

Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.

Referenssisääntö

Ohjausruudut tai allekirjoitetut multimodaaliset viitteet: Ruututila hyväksyy yhden pakollisen ensimmäisen kuvan ja yhden valinnaisen viimeisen kuvan. Viitetila hyväksyy enintään 10 JPEG-kuvaa, läpinäkymätöntä PNG-kuvaa, WebP- tai BMP-kuvaa, kukin 20 MB, 5 MP4/MOV-videota, kukin 95 MB ja 1–15 sekuntia, sekä 5 MP3/WAV-äänileikettä, kukin 15 MB ja 1–15 sekuntia; videon ja äänen kokonaiskesto rajataan erikseen 15 sekuntiin.

Enimmäistiedostot

Hyväksytyt tiedostotyypit

image, video, audio

Duration token

Video- ja äänireferenssien pitäisi kantaa /api/v1/files-reitin durationToken-arvoa, kun keston varmennus vaaditaan.

kind	Enimmäiskoko	MIME-tyypit
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

Minimipyyntö

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

Referenssitiedostopyyntö

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

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

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

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Jotkin moodit vaativat Files API -referenssilatauksia.

Wan 3.0 Video API -integraatio