ГлавнаяМоделиГенерация видеоVeo 3.1 Lite

Veo 3.1 Lite API

ПровайдерGoogle

veo-31-lite — генерация видео-модель от Google.

fastimage_to_videotext_to_video

Попробуйте прямо здесь

Veo 3.1 Lite Открыть в песочнице

Что умеет Veo 3.1 Lite

  • Быстро
  • Видео из изображения
  • Видео по тексту

Стоимость

за секунду
720p
6.6 ₽
1080p
10.56 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
google
Modality
video

Veo 3.1 Lite API для генерации видео

Veo 3.1 Lite — видеомодель Google из США, представленная 31 марта 2026 года. Она выделяется экономичностью для массовой генерации роликов без потери скорости. Модель создает видео со звуком по текстовому описанию или изображению, поддерживает разрешения 720p и 1080p, форматы 16:9 и 9:16, а также длительность 4, 6 или 8 секунд.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreq
string
min: 2 · max: 3000
—
Текстовый промпт описывающий генерируемое видео.
1 пример
Примеры
Девочка-астронавт смотрит на Марс из окна корабля, мягкий синий свет.
width
integer
—
—
Ширина в px. Парный к height — только валидные комбинации (см. ниже). Несовместимо с resolution.
height
integer
—
—
Высота в px. Парный к width. Список валидных значений — см. combos у width.
resolution
enum
720p, 1080p
720p
Resolution preset. Несовместимо с width/height. В Lite-варианте нет 4K.
duration
enum
4, 6, 8
8
Длительность видео в секундах. Только 4, 6 или 8.
seed
integer
min: 0 · max: 4294967295
—
Seed для воспроизводимой генерации (32-bit unsigned). Если не указан — выбирается случайно.
inputs.frameImages
array of strings or objects
min: 1 · max: 2
—
Image-to-video. Каждый item — либо строка, либо объект {image, frame}. 1 image → first, 2 → first+last. Несовместимо с width/height (если задан — размеры наследуются).
2 формата ввода
Format 1: string[]

Image input — URL / UUID / Data URI / Base64.

[
  "https://example.com/first-frame.jpg"
]
Format 2: object[]
ПолеТипЗначенияОписание
imagereqstring—Image input (UUID / URL / Data URI / Base64).
frameenumfirst, last, 0, -1Target frame position: first / last / 0 / -1.
[
  {
    "image": "https://example.com/start.jpg",
    "frame": "first"
  },
  {
    "image": "https://example.com/end.jpg",
    "frame": "last"
  }
]
providerSettings.google.generateAudio
boolean
—
true
Генерировать ли native audio (ambient / music) синхронизированный с видео.
providerSettings.google.personGeneration
enum
dont_allow, allow_adult, allow_all
allow_all
Контроль появления людей в кадре: dont_allow — запрет, allow_adult — только взрослые, allow_all — без ограничений.
providerSettings.google.resizeMode
enum
crop, pad
—
Режим адаптации image к target dimensions. ТРЕБУЕТ inputs.frameImages с 1 item.
numberResults
integer
min: 1 · max: 4
1
Сколько вариаций сгенерировать (разные seeds). Каждая считается отдельно.
outputFormat
enum
MP4, WEBM, MOV
MP4
Контейнер для финального видео.
outputQuality
integer
min: 20 · max: 99
95
Качество компрессии (20–99). Выше — лучше визуально и больше размер файла.
safety.checkContent
boolean
—
false
Включить проверку контента на NSFW / запрещёнку. При true default-режим safety.mode становится fast.
safety.mode
enum
none, fast, full
none
Режим safety-сканера: none — выключен, fast — проверяет ключевые кадры, full — все кадры (медленнее).
webhookURL
string
—
—
URL для POST-уведомления при готовности задачи. При numberResults > 1 webhook триггерится на каждый результат отдельно.
1 пример
Примеры
https://yourapp.com/webhooks/runware
uploadEndpoint
string
—
—
Presigned URL (S3 / GCS / Azure / HTTP PUT) для автозагрузки готового видео. Сырое binary в body PUT-запроса.
1 пример
Примеры
https://bucket.s3.amazonaws.com/result.mp4?X-Amz-Signature=...

Поддерживаемые размеры

Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.

720p (16:9)
1280×720
720p (9:16)
720×1280
1080p (16:9)
1920×1080
1080p (9:16)
1080×1920

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. Видео-генерация всегда async — нет sync-режима.

ПолеТипЗначенияОписание
id
string
—
task_id для GET /v1/tasks/{id}.
object
string
video.task
status
enum
queued, processing, completed, failed
model
string
—
created
integer
—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса.

ПолеТипЗначенияОписание
id
string
—
status
enum
queued, processing, completed, failed, canceled
modality
string
video
model
string
—
data
array
—
Каждый элемент:
  • url— string · CDN URL .mp4 / .webm / .mov.
error
string
—

Пример кода

veo-31-lite_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
    model= "veo-31-lite",
    positivePrompt= "Пример промпта",
    width= 1,
    height= 1,
    resolution= "720p",
    duration= 8,
    seed= 2147483648,
    numberResults= 1,
    outputFormat= "MP4",
    outputQuality= 95,
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
    inputs= {
        "frameImages": []
    },
    providerSettings= {
        "google": {
            "generateAudio": True,
            "personGeneration": "allow_all",
            "resizeMode": "crop"
        }
    },
    safety= {
        "checkContent": False,
        "mode": "none"
    },
)
print(resp)
Полная документация модели

Частые вопросы о Veo 3.1 Lite

Veo 3.1 Lite — модель Google для создания видео со звуком по текстовому описанию или изображению. Она поддерживает ролики в 720p и 1080p.
Модель подходит для массового создания коротких роликов, контента для соцсетей, рекламных материалов и видеосценариев с быстрым запуском генерации.
Подключить модель можно через Ranvik API: сервис предоставляет удобный доступ к API, чтобы встраивать генерацию видео в продукты, сайты и сценарии.
В Ranvik API доступ к Veo 3.1 Lite организован без VPN: зарегистрируйтесь, получите ключ и отправляйте запросы из своего приложения или сервиса.
Да, в Ranvik API можно пополнять баланс и оплачивать использование Veo 3.1 Lite в российских рублях, что упрощает расчеты для российских проектов.
Veo 3.1 Lite создает видео длительностью 4, 6 или 8 секунд, поддерживает форматы 16:9 и 9:16, разрешения 720p и 1080p, а также звук.