Wan 2.7 Video API-integration
Brug Wan 2.7 Video via Rivya Public API v1 med model-id wan-2-7-video, understøttede inputs, parametre, Files API-regler, credits og svareksempler.
wan-2-7-video
text, file
Krævet for referencetilstande
per_output_second · 720p=16 · 1080p=24 · ⌈total⌉
Video
FIXED
5000 tegn
Anmodningskontrakt
Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.
| Nøgle | Type | Krævet | Standard | Beskrivelse |
|---|---|---|---|---|
| model | string | Ja | wan-2-7-video | Brug API-model-id'et wan-2-7-video. |
| prompt | string | Ja | - | Maksimalt 5000 tegn for denne model. |
| params | object | Nej | - | Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys. |
| client_request_id | string | Nej | - | Valgfrit klientside-id til at spore anmodninger i dit system. |
Modelparametre
| Nøgle | Type | Krævet | Standard | Interval | Valgmuligheder | Beskrivelse |
|---|---|---|---|---|---|---|
| resolution | select | Nej | 720p | - | 720p, 1080p | Opløsning |
| duration | number | Nej | 5 | min 0 / max 15 | - | text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s |
| aspect_ratio | select | Nej | 16:9 | - | 16:9, 9:16, 1:1, 4:3, 3:4 | Tekst-til-video- og videoredigeringskørsler bruger dette direkte. Billede-til-video følger i øjeblikket den uploadede frames geometri i stedet for at vise en separat kontakt til bredde-højde-forhold. |
| negative_prompt | text | Nej | - | - | - | prompt ≤ 5000; negative_prompt ≤ 500 |
| prompt_extend | select | Nej | true | - | true, false | Styrer, om modellen omskriver din prompt før generering. Behold den slået til for nemheds skyld, eller slå den fra, når du allerede har en meget præcis prompt. |
| watermark | select | Nej | false | - | false, true | Vandmærke |
| audio_setting | select | Nej | auto | - | auto, origin | Styrer, hvordan lyd håndteres i videoredigeringsvejen. Auto lader modellen beslutte, mens Keep original forsøger at bevare kildevideoens lyd. |
| seed | number | Nej | - | min 0 / max 2147483647 | - | Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match. |
Uploadpolitik
Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.
Referencemedie: Referencemedie: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.
2
image, video
Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.
| kind | Maks. størrelse | MIME-typer |
|---|---|---|
| image | 30 MB | image/jpeg, image/png, image/webp |
| video | 30 MB | video/mp4, video/quicktime |
Minimal anmodning
{
"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": "negative_prompt ≤ 500",
"prompt_extend": "true",
"watermark": "false",
"audio_setting": "auto",
"seed": 0
}
}Referencefilanmodning
{
"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": "negative_prompt ≤ 500",
"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"
}
]
}
}Oprettelsessvar
Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.
{
"id": "task_wan_2_7_video_example",
"status": "queued",
"model": "wan-2-7-video",
"reserved_credits": 80,
"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
}Almindelige fejl
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Nogle tilstande kræver referenceuploads via Files API.
