Skip to main content
POST

Аутентификация

string
обязательно
Все эндпоинты требуют аутентификации по Bearer TokenПолучение API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте в заголовок запроса:

Параметры запроса

string
обязательно
Имя модели генерации видео, фиксированное значение wan2.5-preview
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
Описание содержания видеоОбязательный для text-to-video (без image_urls), опциональный, но рекомендуется для image-to-videoПодробно опишите сцены, действия и стили для лучших результатовПример: "Sunset coastal highway, cinematic shot"
array<string>
Массив URL опорных изображений (поддерживается только 1 изображение)Обязателен в режиме image-to-video, поддерживает публично доступные URL изображений или Base64-кодирование (data:image/png;base64,...)Пример: ["https://example.com/image.jpg"]
Система автоматически выбирает режим text-to-video или image-to-video в зависимости от наличия image_urls. Не передавайте image_urls для режима text-to-video.
string
Негативный промпт, описывающий нежелательное содержаниеМаксимум 500 символовПример: "blurry, low quality, distorted"
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 480p — SD, поддерживает size: 16:9, 9:16, 1:1
  • 720p — HD (по умолчанию), поддерживает size: 16:9, 9:16, 1:1, 4:3, 3:4
  • 1080p — FHD, поддерживает size: 16:9, 9:16, 1:1, 4:3, 3:4
По умолчанию: 720p
Разрешение напрямую влияет на стоимость: 1080p > 720p > 480p.
480p поддерживает только соотношения 16:9, 9:16, 1:1. Передача 4:3 или 3:4 приведёт к ошибке.
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживает только: 5 или 10 секундПо умолчанию: 5
string
по умолчанию:"16:9"
Соотношение сторон, действует только для text-to-video (без image_urls)Варианты зависят от resolution:480p:
  • 16:9 — пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
720p / 1080p:
  • 16:9 — пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
  • 4:3 — пейзаж
  • 3:4 — портрет
По умолчанию: 16:9
Для image-to-video соотношение сторон определяется входным изображением. Не передавайте size, иначе будет возвращена ошибка.
integer
Случайное зерно (≥ 0), указание одного и того же зерна позволяет воспроизводить похожие результатыПример: 12345
boolean
по умолчанию:"true"
Включить ли умное переписывание промптаЗначительно улучшает результаты для коротких промптов, но увеличивает время обработкиПо умолчанию: true
boolean
по умолчанию:"true"
Автоматически добавлять ли аудиоПри включении система генерирует подходящее аудио для видеоПо умолчанию: true
Эта модель поддерживает только audio=true. Установка false для видео без звука не поддерживается.
string
URL пользовательского аудио (wav/mp3, 3–30 секунд, ≤ 15 МБ)Если аудио длиннее длительности видео, оно будет автоматически обрезано; если короче — оставшаяся часть будет без звука
Требования к аудиофайлу:
  • Формат: wav, mp3
  • Длительность: 3–30 секунд
  • Размер: ≤ 15 МБ
boolean
по умолчанию:"false"
Добавлять ли водяной знак «AI Generated» (правый нижний угол)По умолчанию: false

Комбинации разрешения и соотношения сторон

Комбинации size и resolution соответствуют пиксельным размерам восходящего сервиса (действуют только для text-to-video):
480p поддерживает только соотношения 16:9, 9:16, 1:1. Передача 4:3 или 3:4 приведёт к ошибке. 720p и 1080p поддерживают все 5 соотношений.

Ответ

integer
Код статуса ответа, 200 при успехе
array
Массив данных ответа

Сценарии использования

Сценарий 1: Текст в видео (простой)

Сценарий 2: Текст в видео (полный набор параметров)

Сценарий 3: Изображение в видео

Сценарий 4: Изображение в видео (изображение Base64)

Сценарий 5: Пользовательское аудио

Описание режимов

Текст в видео (Text-to-Video)

  • Параметр prompt обязателен
  • Не передавайте image_urls
  • Используйте size для задания соотношения сторон

Изображение в видео (Image-to-Video)

  • Параметр image_urls обязателен (поддерживается только 1 изображение)
  • prompt опционален, используется для описания ожидаемых действий
  • Соотношение сторон определяется входным изображением, не передавайте size
Система автоматически выбирает режим в зависимости от наличия image_urls
Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.