Skip to main content
POST

Авторизация

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

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

string
обязательно
Имя модели генерации видео, фиксированное значение wan2.7-r2v
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Описание содержания видео, до 5000 символовДля нескольких изображений/видео используйте «image 1», «image 2», «video 1» и т. д. для ссылки на соответствующие опорные ресурсы (в порядке передачи)Пример: "The character in image 1 enters the scene in image 2 and looks around"
array<object>
Массив изображений с ролями; должно быть передано хотя бы это поле или video_urlsПоля каждого объекта:
  • url (string): URL изображения
  • role (string): роль изображения
    • reference_image — опорное изображение (по умолчанию)
    • first_frame — заданный первый кадр (когда задан, size игнорируется, соотношение сторон следует первому кадру)
  • reference_voice (string, опционально): URL аудиосэмпла голоса для этого опорного персонажа, используется для управления голосом персонажа в сгенерированном видео
Пример:
array<string>
Массив URL опорных видео, до 5 видео (всего изображений + видео ≤ 5)Должно быть передано хотя бы это поле или image_with_roles
Ограничения видео:
  • Формат: mp4, mov
  • Длительность: 1–30 с
  • Разрешение: ширина и высота в диапазоне [240, 4096] пикселей
  • Соотношение сторон: 1:8 – 8:1
  • Размер файла: до 100 МБ
string
Негативный промпт, описывающий нежелательное содержание, до 500 символов
string
по умолчанию:"1080P"
Разрешение видеоВарианты:
  • 720P — стандартное
  • 1080P — высокая чёткость (по умолчанию)
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживаемый диапазон: 215 секундПо умолчанию: 5
Если опорные ресурсы включают видео: целое число из [2, 10].Если опорные ресурсы не включают видео: целое число из [2, 15].
string
по умолчанию:"16:9"
Соотношение сторонПоддерживаемые форматы:
  • 16:9 — широкоэкранный пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
  • 4:3 — пейзаж
  • 3:4 — портрет
Когда first_frame указан через image_with_roles, этот параметр игнорируется, и соотношение сторон следует изображению первого кадра
boolean
по умолчанию:"true"
Включить ли интеллектуальное переписывание промптаЗначительно улучшает результаты для коротких промптов, но увеличивает время обработкиПо умолчанию: true
boolean
по умолчанию:"false"
Добавлять ли водяной знак «AI Generated» к сгенерированному видео
  • true: добавить водяной знак
  • false: без водяного знака (по умолчанию)
integer
Целое число — зерно для управления случайностью генерируемого содержимогоДиапазон: целое ≥ 0
  • Для идентичных запросов модель генерирует разные результаты при разных значениях seed (например, при пропуске seed)
  • Для идентичных запросов модель генерирует похожие результаты при одинаковом значении seed, но точное совпадение не гарантируется

Ответ

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

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

Сценарий 1: Одно опорное изображение (простейший)

Сценарий 2: Несколько опорных изображений

Сценарий 3: Генерация по опорному видео

Сценарий 4: Заданный первый кадр + опорное изображение

Сценарий 5: Опорное изображение + опорный голос (точное управление)

Правила ссылок на изображения

При нескольких опорных изображениях используйте числовые индексы в prompt для ссылки на них:
  • 1-е изображение → «image 1» или «the first image»
  • 1-е видео → «video 1» или «the first video»
Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.