Wan 2.7 Video API -integraatio
Käytä mallia Wan 2.7 Video Rivya Public API v1:n kautta malli-ID:llä wan-2-7-video; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.
wan-2-7-video
text, file
Vaaditaan referenssimoodeissa
80
Video
FIXED
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-7-video | Käytä wan-2-7-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, 15 | Teksti- ja kuva-ajot voivat käyttää 5, 10 tai 15 sekuntia. Videoeditointi päättyy tällä hetkellä 10 sekuntiin, ja Rivya normalisoi pidemmät valinnat automaattisesti tässä tilassa. |
| aspect_ratio | select | Ei | 16:9 | - | 16:9, 9:16, 1:1, 4:3, 3:4 | Text-to-video- ja video-editing-ajot käyttävät tätä suoraan. Image-to-video seuraa tällä hetkellä ladatun kehyksen geometriaa erillisen kuvasuhdekytkimen sijaan. |
| negative_prompt | text | Ei | - | - | - | Negatiivinen prompti |
| prompt_extend | select | Ei | true | - | true, false | Määrittää, kirjoittaako malli promptisi uudelleen ennen generointia. Pidä se päällä mukavuuden vuoksi tai poista se käytöstä, kun promptisi on jo hyvin tarkka. |
| watermark | select | Ei | false | - | false, true | Vesileima |
| audio_setting | select | Ei | auto | - | auto, origin | Määrittää, miten ääntä käsitellään video-edit-polussa. Auto antaa mallin päättää, kun taas Keep original yrittää säilyttää lähdevideon äänen. |
| 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. |
Latauskäytäntö
Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.
Viitemedia: Lataa enintään 2 aineistoa. Käytä enintään 2 kuvaa image-to-video-polkuun tai 1 video ja 1 valinnainen kuva videoeditointiin.
2
image, video
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/webp |
| video | 95 MB | video/mp4, video/quicktime |
Minimipyyntö
{
"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": "Valinnaiset poissuljennat tai vältettävät virhetilat.",
"prompt_extend": "true",
"watermark": "false",
"audio_setting": "auto",
"seed": 0
}
}Referenssitiedostopyyntö
{
"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": "Valinnaiset poissuljennat tai vältettävät virhetilat.",
"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"
}
]
}
}Create-vastaus
Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.
{
"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
}Yleiset virheet
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Jotkin moodit vaativat Files API -referenssilatauksia.