Wan Animate Replace API-integration
Brug Wan Animate Replace via Rivya Public API v1 med model-id wan-2-2-animate-replace, understøttede inputs, parametre, Files API-regler, credits og svareksempler.
wan-2-2-animate-replace
file
Krævet for referencetilstande
per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉
Video
METERED
Ingen dokumenteret promptgrænse
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-2-animate-replace | Brug API-model-id'et wan-2-2-animate-replace. |
| prompt | string | Ja | - | Prompttekst til modeller, der understøtter tekstinput. |
| 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 | 480p | - | 480p, 580p, 720p | De aktuelle niveauer er `480p`, `580p` og `720p`. Højere outputniveauer betyder normalt højere credit-pris og længere ventetid. |
Uploadpolitik
Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.
video: video, image
2
video, image
Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.
| kind | Maks. størrelse | MIME-typer |
|---|---|---|
| video | 50 MB | video/mp4, video/quicktime, video/webm |
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimal anmodning
{
"model": "wan-2-2-animate-replace",
"params": {
"resolution": "480p"
}
}Referencefilanmodning
{
"model": "wan-2-2-animate-replace",
"params": {
"resolution": "480p",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-video.mp4",
"kind": "video",
"name": "reference-video.mp4",
"mimeType": "video/mp4",
"durationSeconds": 8,
"durationToken": "video_duration_token_from_files_api"
}
]
}
}Oprettelsessvar
Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.
{
"id": "task_wan_2_2_animate_replace_example",
"status": "queued",
"model": "wan-2-2-animate-replace",
"reserved_credits": 6,
"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.
