API-інтеграція для Wan 2.2 A14B Turbo
Використовуйте Wan 2.2 A14B Turbo через Rivya Public API v1 з ID моделі wan-2-2-a14b-turbo, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.
wan-2-2-a14b-turbo
text, file
Потрібно для референсних режимів
12
Відео
FIXED
5000 символів
Контракт запиту
Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.
| Ключ | Тип | Обов'язково | За замовчуванням | Опис |
|---|---|---|---|---|
| model | string | Так | wan-2-2-a14b-turbo | Використовуйте wan-2-2-a14b-turbo як ID моделі API. |
| prompt | string | Так | - | Максимум 5000 символів для цієї моделі. |
| params | object | Ні | - | Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче. |
| client_request_id | string | Ні | - | Необов'язковий клієнтський ID для трасування запитів у вашій системі. |
Параметри моделі
| Ключ | Тип | Обов'язково | За замовчуванням | Діапазон | Опції | Опис |
|---|---|---|---|---|---|---|
| resolution | select | Ні | 720p | - | 480p, 580p, 720p | Текстові запуски та запуски із зображенням зараз лишаються на `480p / 720p`, а шлях із зображенням плюс аудіо також відкриває `580p`. Rivya автоматично фільтрує непідтримувані рівні відповідно до поточного режиму. |
| aspect_ratio | select | Ні | 16:9 | - | 16:9, 9:16 | Це доступно лише в text-to-video, бо поточні публічні кінцеві точки для зображення та зображення плюс аудіо не відкривають стабільного поля `aspect_ratio`. |
| enable_prompt_expansion | select | Ні | false | - | false, true | Увімкніть це, коли хочете, щоб зовнішній сервіс розширив грубий текстовий промпт перед генерацією. Це лишається обмеженим текстовими запусками та запусками із зображенням. |
| seed | number | Ні | - | min 0 / max 2147483647 | - | Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1. |
| acceleration | select | Ні | none | - | none, regular | Легше керування прискоренням, яке лишається обмеженим публічними текстовим і зображеневим режимами. |
| num_frames | number | Ні | 80 | min 40 / max 120 / step 1 | - | Лише для шляху із зображенням плюс аудіо. Допустимі значення від 40 до 120, і число має ділитися на 4. Типова стартова точка - 80. |
| frames_per_second | number | Ні | 16 | min 4 / max 60 / step 1 | - | Лише для шляху із зображенням плюс аудіо. Допустимі значення від 4 до 60. Вищий FPS зазвичай відчувається плавнішим, але також підвищує навантаження генерації. |
| negative_prompt | text | Ні | - | - | - | Лише для шляху із зображенням плюс аудіо. Використовуйте його, щоб описати помилки руху, небажані артефакти або візуальні елементи, яких треба уникнути. |
| num_inference_steps | number | Ні | 27 | min 2 / max 40 / step 1 | - | Лише для шляху із зображенням плюс аудіо. Допустимі значення від 2 до 40. Більше кроків може покращити якість, але також збільшує час виконання. |
| guidance_scale | number | Ні | 3.5 | min 1 / max 10 / step 0.1 | - | Лише для шляху із зображенням плюс аудіо. Допустимі значення від 1 до 10. Вищі значення точніше йдуть за промптом, але можуть зробити рух жорсткішим. |
| shift | number | Ні | 5 | min 1 / max 10 / step 0.1 | - | Лише для шляху із зображенням плюс аудіо. Допустимі значення від 1 до 10. Це змінює відчуття часової зміщеності генерації, тому найбезпечніше починати близько до стандартного значення. |
| enable_safety_checker | select | Ні | true | - | true, false | Лише для шляху із зображенням плюс аудіо. Увімкніть, щоб виконати перевірки безпеки перед генерацією, або вимкніть, коли потрібна слабша фільтрація і ви приймаєте цей компроміс. |
Політика завантаження
Спочатку завантажте референсні файли, потім розмістіть повернений URL і токен тривалості всередині params.referenceMediaItems.
Референсні медіа: Завантажте до 2 матеріалів. Текстовому режиму матеріали не потрібні, image-to-video використовує 1 зображення, а шлях із зображенням плюс аудіо використовує 1 зображення плюс 1 аудіокліп.
2
image, audio
Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.
| kind | Максимальний розмір | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
| audio | 10 MB | audio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/flac, audio/x-ms-wma |
Мінімальний запит
{
"model": "wan-2-2-a14b-turbo",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"acceleration": "none",
"num_frames": 80,
"frames_per_second": 16,
"negative_prompt": "Необов'язкові виключення або режими помилок, яких треба уникнути.",
"num_inference_steps": 27,
"guidance_scale": 3.5,
"shift": 5,
"enable_safety_checker": "true"
}
}Запит із референсним файлом
{
"model": "wan-2-2-a14b-turbo",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"acceleration": "none",
"num_frames": 80,
"frames_per_second": 16,
"negative_prompt": "Необов'язкові виключення або режими помилок, яких треба уникнути.",
"num_inference_steps": 27,
"guidance_scale": 3.5,
"shift": 5,
"enable_safety_checker": "true",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Відповідь створення
Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.
{
"id": "task_wan_2_2_a14b_turbo_example",
"status": "queued",
"model": "wan-2-2-a14b-turbo",
"reserved_credits": 12,
"final_credits": 0,
"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.