Veo 3.1

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

Полная документация API: Генерация медиа

Обзор

Характеристика	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
Авто-перевод промпта	Да	Да

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

Veo 3.1 Quality (veo3):

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

Veo 3.1 Fast (veo3_fast):

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

Возможности

Text-to-Video

Создание видео по текстовому описанию

Image-to-Video

Анимация статичного изображения

Продление видео

Операция extend для продолжения видео

4K апскейлинг

Увеличение разрешения до 4K

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

Рекламные ролики

Короткие видео для рекламы и промо

Социальные сети

Контент для TikTok, Reels, Shorts

Презентации

Визуализация идей и концепций

Прототипирование

Быстрое создание видео-концептов

Примеры запросов

Text-to-Video

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'google/veo3',
    input: {
      prompt: 'Кофейная чашка на столе, пар поднимается вверх, утренний свет из окна',
      aspect_ratio: '16:9'
    }
  })
});

const result = await response.json();
console.log('ID генерации:', result.id);

// Проверка статуса
const status = await fetch(`https://polza.ai/api/v1/media/${result.id}`, {
  headers: { 'Authorization': 'Bearer <POLZA_AI_API_KEY>' }
});
console.log(await status.json());

import requests
import time

# Создание запроса на генерацию видео
response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'google/veo3',
        'input': {
            'prompt': 'Кофейная чашка на столе, пар поднимается вверх, утренний свет из окна',
            'aspect_ratio': '16:9'
        }
    }
)

result = response.json()
generation_id = result['id']
print(f'ID генерации: {generation_id}')

# Проверка статуса
status = requests.get(
    f'https://polza.ai/api/v1/media/{generation_id}',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'}
)
print(status.json())

# Создание запроса на генерацию видео
curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3",
    "input": {
      "prompt": "Кофейная чашка на столе, пар поднимается вверх, утренний свет из окна",
      "aspect_ratio": "16:9"
    }
  }'

# Проверка статуса генерации
curl "https://polza.ai/api/v1/media/{id}" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>"

Image-to-Video с референсным изображением

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'google/veo3',
    input: {
      prompt: 'Плавное движение камеры вперёд, лёгкий ветер колышет листья',
      aspect_ratio: '16:9',
      images: [
        { type: 'url', data: 'https://example.com/landscape.jpg' }
      ]
    }
  })
});

const result = await response.json();
console.log(result);

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'google/veo3',
        'input': {
            'prompt': 'Плавное движение камеры вперёд, лёгкий ветер колышет листья',
            'aspect_ratio': '16:9',
            'images': [
                {'type': 'url', 'data': 'https://example.com/landscape.jpg'}
            ]
        }
    }
)

print(response.json())

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo3",
    "input": {
      "prompt": "Плавное движение камеры вперёд, лёгкий ветер колышет листья",
      "aspect_ratio": "16:9",
      "images": [
        { "type": "url", "data": "https://example.com/landscape.jpg" }
      ]
    }
  }'

Параметры

Параметр	Тип	Обязательный	Описание
`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`)

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

После создания видео вы можете выполнить дополнительные операции:

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

Пример продления видео

const response = await fetch('https://polza.ai/api/v1/media/{id}/operations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    operation: 'extend',
    params: {
      prompt: 'Камера отдаляется, показывая панораму города',
      model: 'quality'
    }
  })
});

const result = await response.json();
console.log(result);

import requests

response = requests.post(
    'https://polza.ai/api/v1/media/{id}/operations',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'operation': 'extend',
        'params': {
            'prompt': 'Камера отдаляется, показывая панораму города',
            'model': 'quality'
        }
    }
)

print(response.json())

curl -X POST "https://polza.ai/api/v1/media/{id}/operations" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "extend",
    "params": {
      "prompt": "Камера отдаляется, показывая панораму города",
      "model": "quality"
    }
  }'

Параметры операции extend

Параметр	Тип	Обязательный	Описание
`prompt`	string	Да	Описание продолжения видео (до 2 000 символов)
`seeds`	number	Нет	Seed для воспроизводимости: 10000-99999
`watermark`	string	Нет	Текст водяного знака (до 50 символов)
`model`	string	Нет	Качество продления: `fast`, `quality`

Примеры промптов

Для продуктов

Вращение продукта на 360 градусов, белый фон, студийное освещение

Для природы

Закат над морем, волны мягко накатывают на берег, камера медленно поднимается

Для людей

Портрет человека, лёгкая улыбка, волосы развеваются на ветру, кинематографичное освещение

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

Описывайте движение

Veo 3.1 лучше работает, когда в промпте явно описано движение: «камера приближается», «объект вращается», «волны движутся».

Указывайте стиль съёмки

Используйте кинематографические термины: «крупный план», «панорама», «tracking shot», «slow motion».

Выбирайте между Quality и Fast

Для тестирования и быстрых итераций используйте google/veo3_fast. Для финального результата — google/veo3 (Quality).

Используйте Image-to-Video

Для большего контроля над результатом загрузите исходное изображение и опишите желаемую анимацию.

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

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

Отправка запроса

POST запрос на /api/v1/media возвращает id генерации

Проверка статуса

GET запрос на /api/v1/media/{id} возвращает текущий статус

Получение результата

Когда статус completed, в ответе будет URL готового видео

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

Продвинутое

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

Интеграции

Обзор

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

Возможности

Text-to-Video

Image-to-Video

Продление видео

4K апскейлинг

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

Рекламные ролики

Социальные сети

Презентации

Прототипирование

Примеры запросов

Text-to-Video

Image-to-Video с референсным изображением

Параметры

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

Пример продления видео

Параметры операции extend

Примеры промптов

Для продуктов

Для природы

Для людей

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

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

Следующие шаги

Статус генерации

Операции над медиа

​Обзор

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

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

Text-to-Video

Image-to-Video

Продление видео

4K апскейлинг

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

Рекламные ролики

Социальные сети

Презентации

Прототипирование

​Примеры запросов

​Text-to-Video

​Image-to-Video с референсным изображением

​Параметры

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

​Пример продления видео

​Параметры операции extend

​Примеры промптов

​Для продуктов

​Для природы

​Для людей

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

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

​Следующие шаги

Статус генерации

Операции над медиа

Обзор

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

Возможности

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

Примеры запросов

Text-to-Video

Image-to-Video с референсным изображением

Параметры

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

Пример продления видео

Параметры операции extend

Примеры промптов

Для продуктов

Для природы

Для людей

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

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

Следующие шаги