Skip to main content
POST
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддержка нескольких режимов генерации, включая текст-в-видео и изображение-в-видео
  • Ссылки на сгенерированные видео действительны в течение 24 часов, сохраните их своевременно
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.

Авторизация

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

Тело запроса

string
по умолчанию:"veo3.1-fast"
обязательно
Название модели генерации видеоДоступные модели:
  • veo3.1-fast - Модель быстрой генерации, подходит для быстрого предпросмотра и итераций
  • veo3.1-quality - Модель высококачественной генерации, подходит для финальной продукции
  • veo3.1-lite - Облегчённая модель генерации, подходит для более дешёвой быстрой генерации
Пример: "veo3.1-fast"
string
обязательно
Текстовое описание для генерации видео
integer
Длительность видео (секунды)Фиксированное значение: 8 (VEO3 поддерживает только 8-секундную длительность)
string
Разрешение видеоПоддерживаемые форматы:
  • 16:9 (горизонтальный)
  • 9:16 (вертикальный)
string[]
Массив URL референсных изображений для генерации изображение-в-видео⚠️ Только формат URL (base64 больше не поддерживается)
  • Публично доступный URL изображения (http:// или https://)
  • Вы можете использовать API загрузки изображений для загрузки локальных изображений и получения URL
Ограничения:
  • Максимальный размер файла: 10MB
  • Поддерживаемые форматы: .jpeg, .jpg, .png, .webp
object
Расширенные параметры, специфичные для VEO3

Ответ

string
Уникальный идентификатор задачи для запроса статуса
string
Тип объекта, всегда generation.task
string
Используемое имя модели
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обработка
  • completed - Успешно завершено
  • failed - Не удалось
integer
Процент выполнения задачи (0-100)
integer
Временная метка создания задачи (временная метка Unix)
object
Метаданные задачи