Veo 3.1

Veo 3.1 — флагманская модель генерации видео от Google DeepMind с поддержкой 4K апскейлинга и продления видео. Доступна в двух вариантах: Quality и Fast.

Обзор

Характеристика	Quality	Fast
ID модели	`google/veo3`	`google/veo3_fast`
Max prompt	2 000 символов	2 000 символов
Aspect ratio	16:9, 9:16, Auto	16:9, 9:16, Auto
Seeds	10000-99999	10000-99999
Watermark	до 50 символов	до 50 символов
Референс-изображения	до 2	до 3
Режимы генерации	TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO	TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
Авто-перевод промпта	Да	Да

Параметры

Параметр	Тип	Обязательный	Описание
`model`	string	Да	ID модели: `google/veo3` (Quality) или `google/veo3_fast` (Fast)
`prompt`	string	Да	Текстовое описание желаемого видео (до 2 000 символов)
`aspect_ratio`	string	Нет	Соотношение сторон: `16:9`, `9:16`, `Auto` (по умолчанию `16:9`)
`images`	array	Нет	Массив референс-изображений (Quality: до 2, Fast: до 3)
`seeds`	number	Нет	Seed для воспроизводимости: 10000-99999
`watermark`	string	Нет	Текст водяного знака (до 50 символов)
`generationType`	string	Нет	Режим генерации: `TEXT_2_VIDEO`, `FIRST_AND_LAST_FRAMES_2_VIDEO`, `REFERENCE_2_VIDEO` (только Fast)
`enableTranslation`	string	Нет	Автоматический перевод промпта на английский: `true`, `false` (по умолчанию `true`)

Пример запроса (cURL)

curl -X POST "https://speshu.ai/api/v1/async/media/tasks" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3",
    "input": {
      "prompt": "Текстовое описание видео",
      "aspect_ratio": "16:9",
      "seeds": 12345,
      "images": [],
      "generationType": "TEXT_2_VIDEO",
      "enableTranslation": "true"
    }
  }'

Возможности

Text-to-Video: Создание видео по текстовому описанию
Image-to-Video: Анимация статичного изображения
Продление видео: Операция extend для продолжения видео
4K апскейлинг: Увеличение разрешения до 4K

Операции над видео

Операция	Описание
`extend`	Продление видео с новым промптом
`upscale_1080p`	Апскейл до 1080p
`upscale_4k`	Апскейл до 4K

Советы и лучшие практики

Описывайте движение: Veo 3.1 лучше работает, когда в промпте явно описано движение. Указывайте стиль съёмки: Используйте кинематографические термины: «крупный план», «панорама», «tracking shot», «slow motion». Выбирайте между Quality и Fast: Для тестирования и быстрых итераций используйте google/veo3_fast. Для финального результата — google/veo3 (Quality). Используйте Image-to-Video: Для большего контроля над результатом загрузите исходное изображение и опишите желаемую анимацию.

Асинхронная генерация

Генерация видео — асинхронный процесс. После отправки запроса вы получите taskId, который нужно использовать для проверки статуса:

Отправка запроса: POST запрос на /api/v1/async/media/tasks возвращает taskId
Проверка статуса: GET запрос на /api/v1/async/media/tasks/{task_id} возвращает текущий статус
Получение результата: Когда статус success, в ответе будет URL готового видео

Начало работы

Продвинутые настройки

Генерация медиа

Интеграции

Обзор

Параметры

Пример запроса (cURL)

Возможности

Операции над видео

Советы и лучшие практики

Асинхронная генерация

​Обзор

​Параметры

​Пример запроса (cURL)

​Возможности

​Операции над видео

​Советы и лучшие практики

​Асинхронная генерация

Обзор

Параметры

Пример запроса (cURL)

Возможности

Операции над видео

Советы и лучшие практики

Асинхронная генерация