Käytä mallia Wan 2.5 Video Rivya Public API v1:n kautta malli-ID:llä wan-2-5-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-2-5-video

Syötteet

text, file

Files API

Vaaditaan referenssimoodeissa

Peruskrediitit

Kyvykkyys

Video

Laskutus

FIXED

Prompt-raja

5000 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-2-5-video	Käytä wan-2-5-video-arvoa API-malli-ID:nä.
prompt	string	Kyllä	-	Enintään 5000 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
resolution	select	Ei	720p	-	720p, 1080p	Resoluutio
duration	select	Ei	5	-	5, 10	Kesto
aspect_ratio	select	Ei	16:9	-	16:9, 9:16, 1:1	Kuvasuhde
enable_prompt_expansion	select	Ei	false	-	false, true	Kun tämä on käytössä, Rivya antaa upstream-mallin laajentaa promptiasi lisäyksityiskohdilla alkuperäisen tarkoituksen säilyttäen. Poista se käytöstä, kun promptisi on jo tiukasti kirjoitettu.
seed	number	Ei	-	min 0 / max 2147483647	-	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.
negative_prompt	text	Ei	-	-	-	Negatiivinen prompti
nsfw_checker	select	Ei	false	-	false, true	NSFW checker

Latauskäytäntö

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

Referenssisääntö

Viitekuva: Lataa enintään 1 kuvatiedosto image-to-video-tilaa varten.

Enimmäistiedostot

Hyväksytyt tiedostotyypit

image

Duration token

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

kind	Enimmäiskoko	MIME-tyypit
image	10 MB	image/jpeg, image/png, image/webp

Minimipyyntö

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Valinnaiset poissuljennat tai vältettävät virhetilat.",
    "nsfw_checker": "false"
  }
}

Referenssitiedostopyyntö

{
  "model": "wan-2-5-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Valinnaiset poissuljennat tai vältettävät virhetilat.",
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create-vastaus

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

{
  "id": "task_wan_2_5_video_example",
  "status": "queued",
  "model": "wan-2-5-video",
  "reserved_credits": 60,
  "final_credits": 0,
  "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 2.5 Video API -integraatio