Skip to main content
POST

Авторизация

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

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

string
обязательно
Имя модели генерации видеоДоступные модели:
  • veo3.1-fast-official — Veo 3.1 Official Fast
  • veo3.1-quality-official — Veo 3.1 Official High Quality
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Положительный текстовый промптПодробно описывайте сцены, действия, стили и так далее для лучших результатов генерации. Рекомендуется использовать промпты на английском языке.Пример: "a golden retriever running on the beach, sunset, cinematic"
string
Негативный промпт для исключения нежелательного содержимогоПример: "blurry, low quality, watermark, text"
integer
по умолчанию:"8"
Длительность видео в секундахРекомендуемые значения: 4 / 6 / 8По умолчанию: 8Примечание: должно быть целым числом (например, 8), не добавляйте кавычки, иначе возникнет ошибка
string
по умолчанию:"16:9"
Соотношение сторон видеоДоступные значения:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
По умолчанию: 16:9
string
по умолчанию:"720p"
Разрешение видеоДоступные значения:
  • 720p — стандартное разрешение
  • 1080p — высокое разрешение
  • 4K — сверхвысокое разрешение
По умолчанию: 720p
string
URL изображения первого кадра для генерации изображение-в-видео
  • URL изображения должен быть публично доступен без защиты от хотлинкинга
  • Рекомендуется использовать URL объектного хранилища, а не временные ссылки на загрузку
string
URL изображения последнего кадра для генерации изображение-в-видеоИспользуется вместе с first_frame_image для управления первым и последним кадрами
integer
Случайное seed-значение для воспроизведения результатов генерацииДиапазон значений: 04294967295
integer
по умолчанию:"1"
Количество генерируемых сэмплов (1-4), в настоящее время рекомендуется использовать 1По умолчанию: 1
boolean
по умолчанию:"false"
Генерировать ли аудиодорожку
string
по умолчанию:"allow_adult"
Политика генерации людейДоступные значения:
  • allow_adult — разрешать генерацию только взрослых людей/лиц
  • disallow — не разрешать генерацию людей или лиц
По умолчанию: allow_adult
string
по умолчанию:"pad"
Стратегия изменения размера изображения (действует для изображение-в-видео)Доступные значения:
  • pad — режим добавления полей
  • crop — режим обрезки
По умолчанию: pad
boolean
по умолчанию:"true"
Включать ли улучшение промпта на стороне провайдераПо умолчанию: true
  • Этот параметр можно установить только в true. Значение false приведёт к ошибке запроса
  • Если этот параметр не нужен, не включайте его

Текст-в-видео и изображение-в-видео

Система автоматически определяет режим в зависимости от того, передаются ли параметры с изображениями: без изображений — текст-в-видео, с изображениями — изображение-в-видео.

Ответ

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

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

Сценарий 1: текст-в-видео (базовый)

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

Сценарий 3: изображение-в-видео (один первый кадр)

Сценарий 4: изображение-в-видео (первый и последний кадр)

Сценарий 5: видео со звуком

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