Skip to main content
POST
Совместимость названий моделей: данный интерфейс также поддерживает алиасы veo3.1-fast-ext (эквивалент veo3.1-fast), veo3.1-quality-ext (эквивалент veo3.1-quality), veo3.1-lite-ext (эквивалент veo3.1-lite); они взаимозаменяемы с основными названиями и дают одинаковый результат.

Авторизация

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

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

string
по умолчанию:"veo3.1-fast"
обязательно
Имя модели генерации видеоДоступные модели:
  • veo3.1-fast — модель быстрой генерации, подходит для быстрого предпросмотра и итераций (совместимый алиас veo3.1-fast-ext)
  • veo3.1-quality — модель высокого качества, подходит для финального производства (совместимый алиас veo3.1-quality-ext)
  • veo3.1-lite — облегчённая модель генерации, подходит для недорогой пакетной генерации (совместимый алиас veo3.1-lite-ext)
Пример: "veo3.1-fast"
Для совместимости со старыми вызовами алиасы veo3.1-fast-ext (соответствует veo3.1-fast), veo3.1-quality-ext (соответствует veo3.1-quality), veo3.1-lite-ext (соответствует veo3.1-lite) по-прежнему доступны для использования.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации видео
integer
Длительность видео в секундахФиксированное значение: 8 (VEO3 поддерживает только длительность 8 секунд)
string
Соотношение сторон видеоПоддерживаемые форматы:
  • 16:9 (горизонтальное)
  • 9:16 (вертикальное)
string
Тип генерации видеоПоддерживаемые типы:
  • frame — видео из кадров (режим FL)
  • reference — видео на основе референсного изображения
Если не указано, определяется по количеству изображений: 2 изображения для видео из кадров, 3 изображения для видео на основе референсного изображенияПримечание: модель veo3.1-quality не поддерживает режим reference
Модель veo3.1-lite не поддерживает этот параметр, не передавайте его
array<url>
Массив URL референсных изображений для генерации изображение-в-видеоПоддерживает публично доступные URL изображений (http:// или https://)Пример: ["https://example.com/image.jpg"]Ограничения:
  • Максимум 3 изображения
  • Для режима «видео из кадров»: первое изображение — начальный кадр, второе — конечный кадр
  • Максимальный размер файла: 10 МБ
  • Поддерживаемые форматы: .jpeg, .jpg, .png, .webp
Модель veo3.1-lite не поддерживает этот параметр, не передавайте его
string
Разрешение видеоПоддерживаемые значения:
  • 720p (по умолчанию)
  • 1080p
  • 4k
boolean
Включить вывод в формате GIF. По умолчанию: falseПримечание: GIF и разрешение 1080p/4k нельзя использовать одновременно
boolean
по умолчанию:"false"
Использовать ли официальный канал в качестве резервного
  • false — не использовать (по умолчанию)
  • true — использовать официальный канал
Модель veo3.1-lite не поддерживает этот параметр, не передавайте его

Ответ

integer
Код состояния ответа
array
Массив данных ответа