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

​
Обзор

ХарактеристикаQualityFast
ID моделиgoogle/veo3google/veo3_fast
Max prompt2 000 символов2 000 символов
Aspect ratio16:9, 9:16, Auto16:9, 9:16, Auto
Seeds10000-9999910000-99999
Watermarkдо 50 символовдо 50 символов
Референс-изображениядо 2до 3
Режимы генерацииTEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEOTEXT_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());

​
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);

​
Параметры

ПараметрТипОбязательныйОписание
modelstringДаID модели: google/veo3 (Quality) или google/veo3_fast (Fast)
promptstringДаТекстовое описание желаемого видео (до 2 000 символов)
aspect_ratiostringНетСоотношение сторон: 16:9, 9:16, Auto (по умолчанию 16:9)
imagesarrayНетМассив референс-изображений (Quality: до 2, Fast: до 3)
seedsnumberНетSeed для воспроизводимости: 10000-99999
watermarkstringНетТекст водяного знака (до 50 символов)
generationTypestringНетРежим генерации: TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO (только Fast). Авто-определяется по наличию изображений, если не указан
enableTranslationstringНетАвтоматический перевод промпта на английский: 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);

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

ПараметрТипОбязательныйОписание
promptstringДаОписание продолжения видео (до 2 000 символов)
seedsnumberНетSeed для воспроизводимости: 10000-99999
watermarkstringНетТекст водяного знака (до 50 символов)
modelstringНетКачество продления: fast, quality

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

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

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

​
Для природы

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

​
Для людей

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

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

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

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

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

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

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

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

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

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

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

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

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

Проверка статуса генерации медиа

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

Продление и апскейлинг видео