Rivya AI Docs
Сторінки API моделей

API-інтеграція для Wan 2.2 A14B Turbo

Використовуйте Wan 2.2 A14B Turbo через Rivya Public API v1 з ID моделі wan-2-2-a14b-turbo, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.

Доступно через APIТекст або URL готові; референсні режими використовують Files APIВідео
ID моделі API

wan-2-2-a14b-turbo

Входи

text, file

Files API

Потрібно для референсних режимів

Базові кредити

12

Можливість

Відео

Білінг

FIXED

Ліміт промпта

5000 символів

Контракт запиту

Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.

КлючТипОбов'язковоЗа замовчуваннямОпис
modelstringТакwan-2-2-a14b-turboВикористовуйте wan-2-2-a14b-turbo як ID моделі API.
promptstringТак-Максимум 5000 символів для цієї моделі.
paramsobjectНі-Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_idstringНі-Необов'язковий клієнтський ID для трасування запитів у вашій системі.

Параметри моделі

КлючТипОбов'язковоЗа замовчуваннямДіапазонОпціїОпис
resolutionselectНі720p-480p, 580p, 720pТекстові запуски та запуски із зображенням зараз лишаються на `480p / 720p`, а шлях із зображенням плюс аудіо також відкриває `580p`. Rivya автоматично фільтрує непідтримувані рівні відповідно до поточного режиму.
aspect_ratioselectНі16:9-16:9, 9:16Це доступно лише в text-to-video, бо поточні публічні кінцеві точки для зображення та зображення плюс аудіо не відкривають стабільного поля `aspect_ratio`.
enable_prompt_expansionselectНіfalse-false, trueУвімкніть це, коли хочете, щоб зовнішній сервіс розширив грубий текстовий промпт перед генерацією. Це лишається обмеженим текстовими запусками та запусками із зображенням.
seednumberНі-min 0 / max 2147483647-Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.
accelerationselectНіnone-none, regularЛегше керування прискоренням, яке лишається обмеженим публічними текстовим і зображеневим режимами.
num_framesnumberНі80min 40 / max 120 / step 1-Лише для шляху із зображенням плюс аудіо. Допустимі значення від 40 до 120, і число має ділитися на 4. Типова стартова точка - 80.
frames_per_secondnumberНі16min 4 / max 60 / step 1-Лише для шляху із зображенням плюс аудіо. Допустимі значення від 4 до 60. Вищий FPS зазвичай відчувається плавнішим, але також підвищує навантаження генерації.
negative_prompttextНі---Лише для шляху із зображенням плюс аудіо. Використовуйте його, щоб описати помилки руху, небажані артефакти або візуальні елементи, яких треба уникнути.
num_inference_stepsnumberНі27min 2 / max 40 / step 1-Лише для шляху із зображенням плюс аудіо. Допустимі значення від 2 до 40. Більше кроків може покращити якість, але також збільшує час виконання.
guidance_scalenumberНі3.5min 1 / max 10 / step 0.1-Лише для шляху із зображенням плюс аудіо. Допустимі значення від 1 до 10. Вищі значення точніше йдуть за промптом, але можуть зробити рух жорсткішим.
shiftnumberНі5min 1 / max 10 / step 0.1-Лише для шляху із зображенням плюс аудіо. Допустимі значення від 1 до 10. Це змінює відчуття часової зміщеності генерації, тому найбезпечніше починати близько до стандартного значення.
enable_safety_checkerselectНіtrue-true, falseЛише для шляху із зображенням плюс аудіо. Увімкніть, щоб виконати перевірки безпеки перед генерацією, або вимкніть, коли потрібна слабша фільтрація і ви приймаєте цей компроміс.

Політика завантаження

Спочатку завантажте референсні файли, потім розмістіть повернений URL і токен тривалості всередині params.referenceMediaItems.

Правило референсів

Референсні медіа: Завантажте до 2 матеріалів. Текстовому режиму матеріали не потрібні, image-to-video використовує 1 зображення, а шлях із зображенням плюс аудіо використовує 1 зображення плюс 1 аудіокліп.

Максимум файлів

2

Прийняті типи файлів

image, audio

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kindМаксимальний розмірMIME types
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/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.