Wan 2.5 Video API-integrasjon
Bruk Wan 2.5 Video via Rivya Public API v1 med modell-ID wan-2-5-video, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.
wan-2-5-video
text, file
Kreves for referansemoduser
60
Video
FIXED
5000 tegn
Forespørselskontrakt
Send modell-ID-en på toppnivå. Modellspesifikke kontroller hører hjemme i params.
| Nøkkel | Type | Påkrevd | Standard | Beskrivelse |
|---|---|---|---|---|
| model | string | Ja | wan-2-5-video | Bruk API-modell-ID-en wan-2-5-video. |
| prompt | string | Ja | - | Maksimalt 5000 tegn for denne modellen. |
| params | object | Nei | - | Modellspesifikt parameterobjekt. Bruk radene nedenfor for tillatte nøkler. |
| client_request_id | string | Nei | - | Valgfri klient-ID for sporing av forespørsler i systemet ditt. |
Modellparametere
| Nøkkel | Type | Påkrevd | Standard | Område | Alternativer | Beskrivelse |
|---|---|---|---|---|---|---|
| resolution | select | Nei | 720p | - | 720p, 1080p | Oppløsning |
| duration | select | Nei | 5 | - | 5, 10 | Varighet |
| aspect_ratio | select | Nei | 16:9 | - | 16:9, 9:16, 1:1 | Sideforhold |
| enable_prompt_expansion | select | Nei | false | - | false, true | Når dette er slått på, lar Rivya oppstrømsmodellen utvide prompten din med ekstra detaljer samtidig som den opprinnelige intensjonen bevares. Slå det av når du allerede har en stramt skrevet prompt. |
| seed | number | Nei | - | min 0 / max 2147483647 | - | La det stå tomt for et nytt tilfeldig resultat hver gang. Å bruke samme heltall på nytt gjør det enklere å gjenskape eller finjustere et tidligere resultat. Det holder seg bare nærmere når prompten og andre viktige innstillinger også forblir like, og det er ikke en garantert 1:1-match. |
| negative_prompt | text | Nei | - | - | - | Negativ prompt |
| nsfw_checker | select | Nei | false | - | false, true | NSFW-sjekk |
Opplastingspolicy
Last opp referansefiler først, og plasser deretter returnert URL og varighetstoken i params.referenceMediaItems.
Referansebilde: Last opp opptil 1 bildefil for bilde-til-video-modus.
1
image
Video- og lydreferanser bør ha durationToken fra /api/v1/files når varighetsverifisering kreves.
| kind | Maks størrelse | MIME-typer |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimal forespørsel
{
"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": "Valgfrie ekskluderinger eller feilmoduser å unngå.",
"nsfw_checker": "false"
}
}Referansefilforespørsel
{
"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": "Valgfrie ekskluderinger eller feilmoduser å unngå.",
"nsfw_checker": "false",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Opprettelsessvar
Create-endepunktet returnerer en offentlig oppgave-ID. Poll statusendepunktet til oppgaven lykkes eller mislykkes.
{
"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
}Vanlige feil
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Noen moduser krever referanseopplastinger via Files API.