Skip to main content
POST

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

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

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

string
обязательно
Название модели генерации видео. Должно быть Omni-Flash-Ext.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Описание содержимого видео. Рекомендуем подробно описывать сцену, субъект, действие, окружение, движение камеры, визуальный стиль и звуковые подсказки.Пример: "a girl is dancing happily in a sunny garden"
integer
по умолчанию:"6"
Длительность видео в секундах.Поддерживаемые значения: 4, 6, 8, 10.
Другие значения, такие как 5 или 7, вернут ошибку invalid_duration.
Не передавайте duration при загрузке референсного видео. duration и video_urls нельзя передавать одновременно.
string
по умолчанию:"720p"
Разрешение видео. Значения нечувствительны к регистру.Поддерживаемые значения:
  • 720p
  • 1080p
  • 4k
Другие разрешения вернут ошибку invalid_resolution.
string
по умолчанию:"16:9"
Соотношение сторон видео. Используется для выбора горизонтального или вертикального вывода.Распространённые значения:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
По умолчанию: 16:9
string
Поле совместимости. Имеет то же значение, что и aspect_ratio. Если переданы оба, поддерживайте их согласованность.
string
Тип генерации, определяющий способ использования изображений.Возможные значения:
  • frame - Режим первого кадра. В image_urls можно загрузить только 1 изображение, которое используется как первый кадр видео.
  • reference - Режим референса. В image_urls можно загрузить 1 или 3 изображения, которые используются как референсные изображения.
Когда generation_type равен frame, image_urls поддерживает только 1 изображение; передача любого другого количества вернёт ошибку unsupported_image_count.
array<url>
Массив URL референсных изображений. В зависимости от generation_type можно не указывать, передать 1 изображение или 3 изображения:
  • Не указан или пустой массив: Text-to-Video
  • 1 изображение: Image-to-Video по одному изображению
  • 3 изображения: слияние референсных изображений (поддерживается только при generation_type равном reference)
Связь с generation_type:
  • generation_type равен frame: можно загрузить только 1 изображение.
  • generation_type равен reference: можно загрузить 1 или 3 изображения.
Поддерживаются только публично доступные URL изображений.
Режим «первый кадр + последний кадр» с 2 изображениями не поддерживается. Передача 2 изображений вернёт ошибку unsupported_image_count. 4 и более изображений полностью не проверены и не рекомендуются.
array<url>
Массив URL референсных видео. Можно не указывать или передать 1 референсное видео.Поддерживаются только публично доступные HTTP/HTTPS URL видео. Можно передавать вместе с image_urls: изображения используются как референс идентичности или композиции, а видео — как референс движения.
Omni-Flash-Ext поддерживает только 0 или 1 референсное видео. Передача 2 или более видео вернёт ошибку unsupported_video_count.
Не передавайте duration при передаче video_urls. video_urls и duration нельзя передавать одновременно.

Ответ

integer
Код состояния ответа. Успешные запросы возвращают 200.
array
Возвращаемый массив задач.

Получение результата задачи

Генерация видео асинхронна. После отправки API возвращает task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты.
cURL
Рекомендуем подождать 5–10 секунд после отправки перед первым запросом, а затем опрашивать каждые 5–10 секунд. Обычно одна задача выполняется примерно за 3–5 минут.

Пример успешного результата

Пример неудачного результата

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

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

Сценарий 2: видео по одному изображению

Сценарий 3: слияние 3 референсных изображений

Сценарий 4: короткое видео 4K

Сценарий 5: генерация с референсным видео

Коды ошибок

При сбое задачи API статуса задачи возвращает причину сбоя в data.error. Распространённые причины включают временное исчерпание квоты у поставщика, провал модерации содержимого или таймаут со стороны поставщика.