Veo 3 — видео-модель Google, которая генерирует ролик сразу со звуком: диалогами, шумами окружения и эффектами. Официальный API Google из России не работает: регистрация и оплата российскими картами недоступны. В этой статье — как разработчику из России подключить генерацию видео Veo через API PlusVibe: какой запрос отправить, как дождаться результата и сколько это стоит.
Сразу уточним про названия: в каталоге PlusVibe модель представлена как veo-3.1 — это актуальная версия линейки Veo 3. Все запросы и цены ниже относятся именно к ней.
Что умеет Veo 3.1 и чем она отличается от других видео-моделей
По публичным материалам Google, сильные стороны Veo 3.1:
- Нативный звук. Модель сама генерирует звуковую дорожку к видео: реплики персонажей, звуки окружения, эффекты. Это фирменная возможность линейки — «видео встречает аудио».
- Реалистичная физика и следование промпту. Google отдельно отмечает качество физики движения и точность, с которой модель следует описанию сцены.
- Несколько режимов генерации. Помимо «текст → видео», поддерживаются переход между первым и последним кадрами и генерация по референсным изображениям.
- Разрешение до 4K. Доступны варианты 720p, 1080p и 4K.
Все ролики, созданные Veo, Google помечает невидимой меткой SynthID — это стоит учитывать, если вы публикуете такие видео.
В каталоге PlusVibe несколько десятков видео-моделей: Kling, Seedance, Wan, Hailuo, Pika, Runway, Luma, MiniMax, Pixverse и другие. От большинства из них Veo отличается тремя вещами:
- Цена за ролик, а не за секунду. Многие видео-модели тарифицируются посекундно. У Veo длительность 4, 6 или 8 секунд на цену не влияет — вы платите за готовый клип.
- Звук встроен по умолчанию. У части моделей звука нет вовсе, у других он включается отдельным параметром запроса. У Veo звук генерирует сама модель, отдельного переключателя нет.
- Три уровня качества. Lite, Fast и Quality — можно выбирать между скоростью, ценой и качеством в рамках одной модели.
Как писать промпты для Veo — что описывать в сцене, как задавать камеру и референсы — у нас есть отдельная статья: «Veo 3.1: как писать промпты для коротких AI-видео». Здесь сосредоточимся на подключении через API.
Почему API Google недоступен из России
Veo доступна разработчикам через Gemini API и Google Cloud. Google не предоставляет доступ к этим сервисам пользователям и организациям из России. На практике это означает:
- регистрация в Google AI Studio и Google Cloud блокируется для российских пользователей;
- оплатить использование российскими банковскими картами невозможно — зарубежные платёжные системы такие транзакции не проводят;
- даже при обходе географических ограничений оплата и выставление документов для российской бухгалтерии остаются нерешаемыми.
Рабочий путь для разработчика в России — российский API-агрегатор, который держит доступ к генерации на своей инфраструктуре. Вы отправляете запрос на российский эндпоинт с российским ключом, сервис выполняет генерацию и возвращает результат, а деньги и документы остаются внутри российской юрисдикции.
Как устроена генерация видео через API PlusVibe
PlusVibe API отдаёт Veo 3.1 через асинхронный медиа-API (маршрут указан прямо в каталоге: Google Veo 3.1 через медиа-провайдера). Схема всегда одна и та же: вы отправляете задачу, получаете её идентификатор и опрашиваете статус до завершения.
Три эндпоинта, которые нужны:
POST /api/media/generate— создать задачу. Авторизация — ваш ключsk-pv-…в заголовкеAuthorization: Bearer, тот же ключ, что и для текстовых моделей.GET /api/media/jobs/{jobId}— статус задачи.POST /api/media/public-price— предварительная оценка стоимости по точным параметрам, без запуска генерации.
Важно понимать асинхронную природу: генерация видео занимает время — от десятков секунд до нескольких минут. Сервер не держит HTTP-соединение открытым: он сразу отвечает 202 с идентификатором задачи, а результат вы забираете опросом.
Шаг 1. Отправить задачу
curl -sS https://plusvibeapi.ru/api/media/generate \
-H "Authorization: Bearer $PLUSVIBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3.1",
"prompt": "A ceramic cup on a wooden table near a window, morning sunlight slowly moving across the surface, steam rising from tea, smooth dolly-in, soft background blur, 8 seconds",
"opts": {
"tier": "fast",
"generationType": "TEXT_2_VIDEO",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": 8
}
}'При успехе приходит 202:
{
"ok": true,
"jobId": "cm…",
"status": "processing",
"model": "veo-3.1",
"priceRub": 37.68
}Если на балансе не хватает денег, сервер вернёт 402 с требуемой суммой; если параметры неверные — 422 с сообщением, какой именно параметр не поддерживается.
Шаг 2. Опрашивать статус
curl -sS "https://plusvibeapi.ru/api/media/jobs/$JOB_ID" \
-H "Authorization: Bearer $PLUSVIBE_API_KEY"Статусы задачи: submitting и processing — ещё в работе, success — готово, fail — не получилось. Опрашивайте раз в несколько секунд. Успешная задача возвращает ссылки на готовые файлы:
{
"status": "success",
"resultUrls": ["https://plusvibeapi.ru/api/media/file/cm…/0"],
"priceRub": 37.68,
"failMsg": null
}Ссылки из resultUrls нужно использовать как возвращены — конструировать или изменять их не нужно.
Если задача завершилась ошибкой, она приходит со status: "fail", priceRub: 0 и полями failReason / failReasonMessage, которые объясняют причину — например, провайдер не смог скачать ваше референсное изображение. Неудачная генерация не списывает деньги. Типичные причины отказов: недоступная или битая ссылка на исходное изображение, неподдерживаемая комбинация параметров, реже — сбой на стороне генерации.
Вместо опроса можно один раз зарегистрировать mediaWebhookUrl — тогда API сам пришлёт POST при завершении задачи; детали в разделе документации про вебхуки медиа-задач.
Какие параметры поддерживает Veo 3.1
Контракт строгий: принимаются только перечисленные параметры, любой другой ключ в opts отклоняется с 422 до запуска генерации.
tier—lite,fastилиquality. Если не передать, по умолчанию используетсяquality— самый дорогой вариант, поэтому уровень качества лучше всегда указывать явно.generationType—TEXT_2_VIDEO(по умолчанию),FIRST_AND_LAST_FRAMES_2_VIDEOилиREFERENCE_2_VIDEO.aspect_ratio—16:9(по умолчанию) или9:16.resolution—720p(по умолчанию),1080pили4k.duration—4,6или8секунд; в режиме референсов доступна только8.imageUrls— массив публичных HTTP(S) ссылок на изображения: 1–2 для перехода по первому/последнему кадру, 1–3 для референсов; дляTEXT_2_VIDEOне передаётся.
Ограничения, о которые чаще всего спотыкаются:
- режим
REFERENCE_2_VIDEOдоступен только в уровняхliteиfast— вqualityон отклоняется; - параметра звука нет: дорожку генерирует сама модель, отключить или заменить её через запрос нельзя;
- ссылки в
imageUrlsдолжны быть доступны без авторизации — иначе провайдер их не скачает и задача упадёт.
Полный список параметров с ценами по каждой комбинации — на странице каталога моделей; машинно его отдаёт GET /api/media-catalog (публично, без ключа).
Цены: сколько стоит ролик Veo 3.1
Единица тарификации — ролик. Длительность 4, 6 или 8 секунд на цену не влияет, соотношение сторон тоже. Стоимость определяется уровнем качества и разрешением. Цены ориентировочные, на 28 августа 2026 года:
| Уровень | 720p | 1080p | 4K |
|---|---|---|---|
| Lite | 17,39 ₽ | 20,29 ₽ | 86,94 ₽ |
| Fast | 34,78 ₽ | 37,68 ₽ | 104,33 ₽ |
| Quality | 144,91 ₽ | 147,80 ₽ | 214,46 ₽ |
То есть вход в Veo — от 17,3 ₽ за готовый ролик со звуком (Lite, 720p), потолок — 214,46 ₽ за ролик в Quality и 4K. Точную сумму по вашим параметрам показывает ответ при отправке задачи и финальный статус: для принятой задачи указанная там рублёвая цена и есть сумма списания.
Пример расчёта. Продающий ролик для карточки товара: 8 секунд, 1080p, уровень Fast — 37,68 ₽ за клип. Типичный рабочий процесс — сделать несколько дешёвых черновиков в Lite 720p (17,39 ₽ за штуку), выбрать удачный промпт и уже финальную версию рендерить в Fast или Quality. Бюджет на 5 черновиков и один финал в 1080p — около 125 ₽.
Отдельная операция — продление готового ролика (POST /api/media/veo/extend): она продолжает клип, сохраняя картинку и звук; тарифицируется отдельно и считается по тому же асинхронному сценарию.
Оплата в рублях и документы для юрлиц
Все расчёты — в рублях, без валютных счетов и зарубежных карт. Баланс пополняется банковской картой (Visa, Mastercard, МИР) или через СБП — для физических лиц и ИП; организации и ИП могут платить безналичным расчётом по счёту.
Для организаций и ИП формируются закрывающие документы: счёт на оплату, акт об оказании услуг, а при применимом режиме налогообложения — счёт-фактура или УПД. Документы предоставляются в электронном виде и (или) через оператора ЭДО.
Для юридических лиц доступна постоплата — договорная отсрочка оплаты по фактическому потреблению API (ст. 823 ГК РФ). Это не кредит и не автоматическое право: условия фиксируются в подписанном соглашении. Порядок такой:
- работа начинается с предоплаты — по её истории рассматривается заявка на отсрочку;
- первый лимит — до 5 000 ₽: карточка организации, проверка по открытым реестрам и соглашение, подписанное уполномоченным лицом; срок оплаты — 14 календарных дней;
- до 10 000 ₽ лимит увеличивается после двух периодов, оплаченных полностью и в срок, с повторной проверкой;
- больше 10 000 ₽ — индивидуальные условия и отдельное согласование.
Исполнитель — ИП на УСН, поэтому НДС не предъявляется: в счёте и первичном документе указывается «Без НДС». Закрывающие документы формируются по фактически потреблённым услугам за календарный месяц и направляются через ЭДО.
Честные ограничения, о которых стоит знать
- Генерация асинхронная и не мгновенная. Ролик готовится от десятков секунд до нескольких минут; закладывайте опрос статуса или вебхук, а не ждите ответ в одном запросе.
- Задачи иногда падают. Причина приходит в
failReason, деньги за неудачную генерацию не списываются. Повторный запуск — обычный элемент интеграции. - Звуком нельзя управлять. Отдельного параметра аудио у Veo в нашем контракте нет: дорожка генерируется вместе с видео, отключить её нельзя. Если нужен ролик без звука — глушите дорожку при монтаже.
- Цены ориентировочные. Каталог отдаёт цены с пометкой «ориентировочная»; точная сумма по конкретным параметрам видна в ответе при отправке и в финальном статусе задачи.
- Строгий контракт. Всё, что выходит за шесть описанных параметров, отклоняется до генерации — это защита от случайных платных запросов с неожиданными настройками.
- Метка SynthID. Видео, созданные Veo, помечаются водяным знаком Google — учитывайте это в своих продуктах.
Итог
Прямой доступ к Veo API от Google из России закрыт, но модель доступна через PlusVibe API: один асинхронный эндпоинт, строгий контракт из шести параметров, цена за ролик от 17,3 ₽, оплата в рублях с документами через ЭДО и постоплатой для юрлиц. Ключ создаётся в кабинете за пару минут, дальше нужен только POST /api/media/generate и опрос статуса задачи. Начать проще с дешёвых черновиков в Lite — а как выжать максимум из самого промпта, читайте в статье про промпты для Veo 3.1.