u usellm
Войти

Veo 3.1

Генерация видео с моделью Veo 3.1 от Google

Veo 3.1

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

Обзор

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

Параметры

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

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

Veo 3.1 Quality (veo3):

curl -X POST "https://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_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://api.usellm.ru/v1/media" \
  -H "Authorization: Bearer <USELLM_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

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

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

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

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

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

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

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

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

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

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

Для природы

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

Для людей

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

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

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

  1. Отправка запроса: POST на /v1/media возвращает id генерации
  2. Проверка статуса: GET на /v1/media/{id} возвращает текущий статус
  3. Получение результата: когда статус completed, в ответе будет URL готового видео

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