Skip to main content
POST

Авторизация

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

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

string
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • viduq3-pro — Vidu Q3 Pro
  • viduq3-turbo — Vidu Q3 Turbo
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовый промпт, максимум 2000 символовОбязателен для text-to-video. Опционален для image-to-video и режима «первый и последний кадры».Пример: "A cat playing piano, camera slowly zooms in"
integer
по умолчанию:"5"
Длительность видео (секунды)Диапазон: 116По умолчанию: 5
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 540p — стандартное разрешение
  • 720p — HD (по умолчанию)
  • 1080p — Full HD
По умолчанию: 720p
string
Соотношение сторон видео (только для режима text-to-video)Варианты:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
  • 4:3 — традиционное
  • 3:4 — традиционное портретное
  • 1:1 — квадратное
Этот параметр доступен только в режиме text-to-video (когда image_urls не указан).
array<url>
Массив URL изображений для генерации image-to-videoСистема автоматически определяет режим генерации по количеству изображений:
  • 0 изображений (не указано): режим text-to-video
  • 1 изображение: режим image-to-video (изображение используется как начальный кадр)
  • 2 изображения: режим «первый и последний кадры» (первое изображение — первый кадр, второе — последний)
Пример: ["https://example.com/photo.jpg"]
  • Поддерживается не более 2 изображений
  • Для режима «первый и последний кадры» должно быть передано ровно 2 изображения
  • Когда image_urls передан (1 или 2 изображения), параметр aspect_ratio использовать нельзя — соотношение сторон видео автоматически определяется по изображению
boolean
по умолчанию:"true"
Генерировать ли звук (диалоги, звуковые эффекты)По умолчанию: trueУстановите false, если требуется видео без звука.
integer
Целочисленный seed для управления случайностью генерируемого контентаДиапазон: целое число от -1 до 2^32-1
  • При одинаковом запросе разные значения seed (включая не указанное или -1, при которых используется случайное число) дадут разные результаты
  • При одинаковом запросе одинаковое значение seed даст похожие результаты, но точная воспроизводимость не гарантируется

Автоматическая маршрутизация

Система автоматически определяет режим генерации по количеству изображений в image_urls:

Матрица поддержки параметров

Ответ

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

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

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

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

Сценарий 3: Видео по первому и последнему кадрам

Сценарий 4: Видео без звука (audio отключён)

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