Skip to main content
POST

Авторизация

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

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

string
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • viduq3-mix — премиум-качество, более сильные интеллектуальные переходы, поддерживает 1-секундные короткие видео
  • viduq3 — выбор по умолчанию, более интеллектуальное переключение ракурсов
Как выбрать: используйте viduq3 для повседневных задач; используйте viduq3-mix для премиум-качества или эффектов движения 1–2 секунды.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовый промпт, максимум 5000 символовОписывайте действия и движения камеры, а не внешний вид (внешний вид определяется референсными изображениями).Пример: "Santa Claus and the bear hug by the lakeside"
array<url>
обязательно
Массив URL референсных изображений, 1–7 изображенийПоддерживает публично доступные URL изображений (http:// или https://)Пример: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Количество: 1–7 изображений
  • Поддерживаемые форматы: PNG, JPEG, JPG, WebP
  • Минимальный размер: 128×128
  • Соотношение сторон: от 1:4 до 4:1
  • Максимальный размер файла: ≤ 50 МБ на изображение
  • Должны быть публично доступными URL
integer
по умолчанию:"5"
Длительность видео (секунды)
  • viduq3-mix: 116
  • viduq3: 316
По умолчанию: 5
viduq3 поддерживает минимум 3 секунды, viduq3-mix — минимум 1 секунду. Передавайте корректную длительность в зависимости от выбранной модели.
string
по умолчанию:"720p"
Разрешение видео
  • viduq3-mix: 720p (по умолчанию) / 1080p
  • viduq3: 540p / 720p (по умолчанию) / 1080p
viduq3-mix не поддерживает 540p, используйте 720p или 1080p.
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 — горизонтальное (по умолчанию)
  • 9:16 — вертикальное
  • 4:3 — традиционное
  • 3:4 — традиционное портретное
  • 1:1 — квадратное
integer
Случайный seed для управления случайностью генерацииЕсли не указан, будет использован случайный seed.
Использование одного и того же seed с идентичными параметрами даст похожие результаты, но не гарантирует полную идентичность.

Сравнение моделей

Ответ

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

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

Сценарий 1: базовая генерация по референсам viduq3

Сценарий 2: viduq3-mix — генерация по референсам с высоким качеством

Получение результатов задачиГенерация видео — это асинхронная задача, при отправке возвращающая task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты генерации.