Интеграция Wan Animate Replace API
Используйте Wan Animate Replace через Rivya Public API v1: ID модели wan-2-2-animate-replace, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
wan-2-2-animate-replace
file
Требуется для референсных режимов
per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉
Видео
METERED
Документированный лимит промпта отсутствует
Контракт запроса
Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | wan-2-2-animate-replace | Используйте wan-2-2-animate-replace как ID модели API. |
| prompt | string | Да | - | Текст промпта для моделей, поддерживающих текстовый ввод. |
| params | object | Нет | - | Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже. |
| client_request_id | string | Нет | - | Необязательный клиентский id для трассировки запросов в вашей системе. |
Параметры модели
| Ключ | Тип | Обязательно | По умолчанию | Диапазон | Варианты | Описание |
|---|---|---|---|---|---|---|
| resolution | select | Нет | 480p | - | 480p, 580p, 720p | Текущие уровни: `480p`, `580p` и `720p`. Более высокие уровни вывода обычно означают большую стоимость в кредитах и более долгое ожидание. |
Политика загрузки
Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.
video: video, image
2
video, image
Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.
| kind | Макс. размер | MIME-типы |
|---|---|---|
| video | 50 MB | video/mp4, video/quicktime, video/webm |
| image | 10 MB | image/jpeg, image/png, image/webp |
Минимальный запрос
{
"model": "wan-2-2-animate-replace",
"params": {
"resolution": "480p"
}
}Запрос с референсным файлом
{
"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"
}
]
}
}Ответ создания
Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.
{
"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
}Распространенные ошибки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Некоторым режимам нужны референсные файлы, загруженные через Files API.
