Skip to main content

​
Обзор

VEO 3.1 Official — это официальный релейный канал APIYI для Google Veo 3.1 — прозрачный passthrough к асинхронным эндпоинтам Google AI Studio veo-3.1-generate-preview / veo-3.1-fast-generate-preview, с идентичными upstream model IDs, response fields и ограничениями. Тарификация по каждому запросу, доступен для вызова в группе Default — самый простой в подключении официальный канал Veo 3.1 с качеством официального уровня, доступный сегодня.
🎬 Основные особенности: Прозрачный passthrough к Google AI Studio + нативный синхронизированный звук + гибкая длительность 4 / 6 / 8 секунд + три уровня разрешения (720p / 1080p / 4k) + тарификация от $0.3 за запрос + Default группа + оплата по каждому запросу или Priority Tokens с оплатой по мере использования (отдельная группа не нужна; чистый Pay-as-you-go не поддерживается). Подходит для рекламных коротких роликов, материалов для e-commerce, контента для соцсетей и демонстраций продукта, когда требуется качество официального уровня при максимально простом подключении.
⚠️ URL CDN не возвращается — вам нужно самостоятельно скачать MP4 stream: В настоящее время канал не возвращает какой-либо публичный / CDN URL для распространения. После status: "completed" вызовите GET /v1/videos/{task_id}/content, чтобы получить MP4 binary и сохраните его в своем OSS / CDN перед выдачей конечным пользователям. Браузеры не могут обращаться к /content напрямую (требуется auth header). См. Эндпоинты API ниже.

API преобразования текста в видео

POST /v1/videos, генерируйте видео только по тексту — JSON-тело запроса, самый простой способ начать.

API преобразования изображения в видео

POST /v1/videos + multipart-загрузка input_reference, чтобы оживить статичное изображение в клип.

Официальный против реверсного

Матрица принятия решений по сравнению с существующим VEO 3.1 (Reverse Channel).

Визуальное тестирование API

Отлаживайте этот эндпоинт напрямую в визуальном инструменте тестирования iCover — код не требуется.

Поиск / загрузка асинхронных задач

Просматривайте отправленные видео-задачи и загружайте ссылки на видео в консоли APIYI — запись для поиска вне API.

​
Почему официальный VEO 3.1 от APIYI?

Полная замена официального канала Google / Vertex AI, оптимизированная для production-сценариев с точки зрения онбординга, стабильности и стоимости:

Официальный passthrough · Идентичные Model IDs

Прозрачный passthrough к асинхронным эндпоинтам Veo 3.1 в Google AI Studio. Model IDs (veo-3.1-generate-preview / veo-3.1-fast-generate-preview) в точности совпадают с upstream, с полным соответствием полей и ограничений запросов и ответов.

Беспроблемный онбординг · Без переключения группы

Вызовы работают в Default группе с Pay-per-request или Pay-as-you-go Priority Tokens (чистый Pay-as-you-go не поддерживается). Отдельное переключение группы не требуется; существующие Pay-per-request Tokens работают как есть — самый беспроблемный официальный канал для Veo 3.1.

Неограниченные параллельные запросы · Production-масштаб

Агрегированный пул аккаунтов с прозрачным proxy — масштабируйте batch-съёмки, рекламные пайплайны и высоконагруженное production-производство линейно. Нет потолка тарифа Google на аккаунт.

Тарификация за запрос · Более чем на 60% дешевле, чем Google

veo-3.1-fast-generate-preview $0.3/req, veo-3.1-generate-preview $1.2/req — единая для 4/6/8 сек и 720p/1080p/4k. По сравнению с официальным 8s 1080p Google, экономия 62–68%, используйте бонусы за пополнение для дополнительной экономии; неудачные задачи не тарифицируются.

Глобальный доступ без трения

Не требуется зарубежный сервер или proxy — подключайтесь к api.apiyi.com напрямую из дата-центров Mainland China, residential-сетей или зарубежных узлов. Полностью обойдитесь без трансграничной настройки Google AI Studio / Vertex AI.

Профессиональная поддержка · Корпоративное внедрение

Наша команда глубоко разбирается в генерации видео: prompt engineering, подборе разрешения, пакетном производстве и постобработке. Полная техническая поддержка от PoC до production для корпоративных клиентов.

​
Ключевые возможности

Нативное синхронизированное аудио

Veo 3.1 изначально выводит видео с синхронизированным аудио (фоновые звуки, диалоги, музыка). Отдельная постобработка аудио не нужна — опишите желаемое аудио в вашем prompt.

Гибкая длительность 4 / 6 / 8 секунд

seconds строковый enum: "4" / "6" / "8". Тарификация за каждый запрос, длительность не влияет на цену. Уровни 1080p / 4k требуют "8".

Три уровня разрешения

720p / 1080p / 4k, единая тарификация за запрос. Свободно переключайте альбомную ориентацию (16:9) и портретную (9:16).

Точное следование инструкциям

Veo 3.1 лидирует в своем классе по движению камеры, физике объектов и точности выражения персонажей. Широкая поддержка ключевых слов языка камеры (push/pull/pan/dolly, низкие/высокие ракурсы).

Изображение в видео (input_reference)

Загрузите одно изображение как визуальную опору для анимации статичного контента. См. Изображение в видео.

Асинхронная модель задач

При отправке сразу возвращается task_id. Отдельно опрашивайте статус и скачивайте итоговое видео — это идеально подходит для пакетного управления и сценариев возобновления после сбоя.

Протокол, совместимый с OpenAI

Аутентификация base_url=https://api.apiyi.com/v1 + Bearer. Работает через raw HTTP или низкоуровневый client.post() OpenAI SDK.

Сбойные запросы бесплатны

В асинхронном режиме неудачные генерации, отклонения по политике контента и ошибки параметров не тарифицируются. Оплачиваются только задачи status=completed.

​
Цены

APIYI использует тарификацию pay-per-request — фиксированная цена в пределах поддерживаемых комбинаций длительности/разрешения, без доплаты за более длинный вывод или более высокое разрешение. По публичным тарифам ai.google.dev/gemini-api/docs/pricing, официальный Veo 3.1 от Google тарифицируется за секунду; указанные ниже скидки рассчитаны для 8-секундных видео.
Примечания по тарификации:
  • Взимается за запрос по названию модели, независимо от длительности (4/6/8 сек), разрешения (720p/1080p/4k) или наличия input_reference — выбор 4K стоит столько же, сколько 720p
  • В асинхронном режиме неудачные генерации / отклонения по политике контента / ошибки емкости не тарифицируются
  • Тарифные уровни бонуса при пополнении в Top-Up Promotions дополнительно снижают эффективную стоимость
  • Рендеринг 4K работает в 4–6 раз медленнее и создает файлы примерно в 10 раз больше — для ежедневного использования по умолчанию выбирайте 1080p
  • Официальный тариф Google для 4K составляет $0.30/сек (fast) / $0.60/сек (standard), то есть $2.40 / $4.80 за 8 сек (источник: ai.google.dev/gemini-api/docs/pricing)

​
Настройка группы

VEO 3.1 Official работает в группе Default (1x), отдельное переключение группы не требуется. Режим тарификации Token должен быть Pay-per-request или Pay-as-you-go Priority — чистый Pay-as-you-go не поддерживается (при необходимости переключите режим Token в консоли).
Сравнение сложности подключения: По сравнению с Sora 2 Official (для которого требуется отдельная группа Sora2Official + только Pay-as-you-go Priority), VEO 3.1 Official работает в группе Default и поддерживает как Pay-per-request, так и Pay-as-you-go Priority — идеально, если вам нужно «подключить уже имеющийся Token Pay-per-request + изменить base_url» без настройки.

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

При разрешении 1080p / 4k seconds должно быть "8" — "4" или "6" будут отклонены upstream. Все три длительности поддерживаются в 720p.

​
Эндпоинты API

⚠️ Только двоичная загрузка MP4 — CDN URL в ответе не возвращаетсяВ настоящее время этот канал не возвращает в ответе никакого CDN / публичного URL — видеофайл можно получить только как MP4 binary stream через GET /v1/videos/{task_id}/content (требуется заголовок Authorization: Bearer).Последствия:
  • В ответе не возвращается video_url / data.url / какая-либо ссылка, которую можно напрямую распространять
  • Фронтенд не может напрямую вставить URL эндпоинта в тег <video> — запросы браузера без заголовка авторизации будут возвращать 401
  • Как только status: "completed", скачайте MP4 и сохраните его в своем собственном OSS / CDN, а затем выдавайте свой URL конечным пользователям
  • Срок хранения видео официально не документирован — не рассчитывайте в долгосрочной перспективе на удаленный task_id для получения видео
Выбор эндпоинта: Основной api.apiyi.com; резервные шлюзы vip.apiyi.com / b.apiyi.com работают одинаково.

​
Key Parameters

⚡ Полная справка по параметрам: перейдите к Text-to-Video - Parameter Reference за полной таблицей, охватывающей типы model / prompt / seconds / size / metadata.*, значения по умолчанию и ограничения. В этом разделе разбираются только 3 наиболее проблемных параметра.

​
seconds (длительность видео)

Поле длительности называется seconds (а не duration) и должно быть строкой ("4" / "6" / "8"). Если передать число, возвращается:
Распространенная ошибка: поле с именем duration тихо игнорируется. duration не распознается этим каналом → оно отбрасывается → длительность откатывается к значению по умолчанию 4 сек.:
  • В 720p (и на других уровнях, где разрешены 4 сек.): ошибки нет, но вы получаете только 4 сек. (это именно тот случай «отправили 8s, получили 4s»)
  • В 1080p / 4k: 4 сек. недопустимы, поэтому возникает ошибка Resolution 1080p requires duration seconds to be 8 seconds, but got 4
Правильное использование: отправляйте поле seconds со значением "8" (строка).
Приоритет параметров: metadata.durationSeconds > seconds > 8

​
metadata.resolution (уровень разрешения)

Приоритет параметров: metadata.resolution > size > 720p

​
⚠️ Не передавайте generateAudio

Veo 3 / 3.1 изначально поддерживает звук, но параметр generateAudio передавать нельзя — вышестоящий сервис отклонит запрос с INVALID_ARGUMENT. Чтобы управлять звуком, запишите намерение в свой prompt:
“Морской маяк в сумерках; волны, далекие морские птицы, тихий ветер, кинематографическая атмосфера”

​
Лучшие практики

1

Выбирайте модель в зависимости от задачи

  • Итерации / пакетные превью → veo-3.1-fast-generate-preview ($0.3/request)
  • Финальная поставка / 4K → veo-3.1-generate-preview ($1.2/request)
  • Запускайте оба варианта с одним и тем же prompt + seed; выбирайте визуально
2

Сначала проверяйте на 4 секундах

Для каждого нового prompt начинайте с seconds: "4", чтобы проверить направление камеры и стиль (рендер 60–90 сек, $0.3). Затем увеличьте до 8 сек или 1080p, когда внешний вид будет зафиксирован.
3

Используйте асинхронный опрос, а не синхронное ожидание

Официальный канал работает только в async-режиме: отправьте POST, чтобы получить task_id → опрашивайте GET /v1/videos/{task_id} каждые 8–10 сек, пока не будет status: "completed" → скачайте из /content. Без webhooks; только опрос.
4

Задавайте таймауты клиента по уровню

  • 720p / 1080p: жесткий таймаут 3 мин
  • 4K: жесткий таймаут 10 мин
  • POST submit (multipart): минимум 30 сек
5

Скачивайте сразу после завершения

Как только status переключится на completed, немедленно скачайте в свой OSS / CDN — не полагайтесь надолго на удаленный task_id. Эндпоинт /content иногда возвращает 400 сразу после переключения status; повторите через 4 секунды (в sample clients это уже встроено).
6

Закладывайте аудио-намерение в prompt

Не передавайте generateAudio (он возвращает INVALID_ARGUMENT). Для фонового звука, диалогов, BGM опишите в prompt: “волны, далёкие морские птицы, слабый ветер”.
7

Ограничивайте rate limit на своей стороне

Ограничения на concurrency публично не документированы; на практике 10 одновременных отправок успешно ставились в очередь. Рекомендуемое ограничение на стороне продакшена — in-flight ≤ 10, с экспоненциальным backoff для 429 / 5xx.

​
Коды ошибок и повторные попытки

Рекомендуемые настройки клиента:
  • Тайм-аут отправки POST: 30 сек (для multipart uploads может потребоваться больше)
  • Интервал опроса: 8–10 сек; максимальное ожидание для 720p/1080p 3 мин, для 4K 10 мин
  • Повтор с экспоненциальной задержкой для 5xx и failed (рекомендуется 1–2 попытки)
  • Повторяйте /content 3–5 раз с интервалом 4 сек

​
Часто задаваемые вопросы

Official (эта страница): Прозрачный passthrough к upstream-эндпоинтам Google AI Studio. ID моделей совпадают с Google upstream (veo-3.1-generate-preview / veo-3.1-fast-generate-preview), цена $0.3 / $1.2 за запрос, только асинхронный эндпоинт.Reverse (существующий VEO 3.1): Доступ к Google Flow, полученный методом reverse engineering. ID моделей относятся к сериям veo-3.1-fast / veo-3.1 / -fl, цена от $0.15 за запрос — дешевле, поддерживает как streaming sync, так и async-режимы, а также frame-to-video (первый/последний кадр).См. полную матрицу выбора Official vs Reverse. Оба канала сосуществуют; выбирайте по бизнес-потребностям.
Поле запроса — seconds (строка "4" / "6" / "8"). Если назвать его duration, оно не распознается — значение молча отбрасывается, и length возвращается к значению по умолчанию 4 сек, что и является корнем проблемы «отправили 8 с, а получили только 4 с».Что касается того, почему оно должно быть строкой: в Go-структуре бэкенда это поле (внутреннее имя duration) объявлено как string, поэтому число отклоняется на уровне декодера с parse_request_failed: cannot unmarshal number into Go struct field ... duration of type string (duration в этой ошибке — внутреннее имя поля бэкенда; ваш запрос по-прежнему отправляет seconds). Запомните: отправляйте seconds и заключайте значение в кавычки: "4" / "6" / "8".
Veo 3 / 3.1 — это видеомодель с встроенной поддержкой аудио, но параметр generateAudio передавать нельзя (upstream возвращает INVALID_ARGUMENT). Чтобы управлять звуком, зашейте намерение в prompt:
«Морской маяк в сумерках; волны, дальние морские птицы, тихий ветер, кинематографичная атмосфера»
  • При одинаковых параметрах время рендеринга примерно одинаковое (по измерениям 720p 8 sec: fast 83s, standard 78s). fast не быстрее — он дешевле ($0.3 vs $1.2)
  • По умолчанию выбирайте veo-3.1-fast-generate-preview
  • Переходите на veo-3.1-generate-preview для финальной поставки или когда важны детализация / физическая согласованность
  • A/B в продакшене: запускайте оба варианта с одинаковыми prompt + seed, выбирайте визуально
Для большинства случаев не рекомендуется:
  • Одинаковая цена за запрос выглядит привлекательно
  • Но рендеринг в 4–6× медленнее (720p 80s → 4K 350s)
  • Файлы примерно в 10× больше (720p 4MB → 4K 40MB) — затраты на трафик и хранение удваиваются
  • 1080p визуально достаточно для большинства сценариев воспроизведения
Когда 4K действительно нужен: используйте veo-3.1-generate-preview, задайте seconds="8" (обязательно), timeout клиента ≥ 10 мин, запускайте как фоновую async-задачу.
  • Webhooks нет; опрашивайте только GET /v1/videos/{task_id}
  • Рекомендуемый интервал опроса: 8 сек (по измерениям достаточно, не приведет к лимиту запросов)
  • Измеренное время: 720p / 1080p 60–115 сек, 4K 5–6 мин
  • Timeout клиента: 3 мин для 720p/1080p, 10 мин для 4K
Сразу после того, как status переключается в completed, вызов /v1/videos/{task_id}/content иногда возвращает 400 из-за задержки синхронизации upstream CDN. Подождите 4 сек и повторите один раз — этого обычно достаточно (в примерах клиентов повтор выполняется 3–5 раз с интервалом 4 секунды).
Пока нет. Этот канал не возвращает CDN / публичный URL в ответе — ни video_url / data.url / никакой другой ссылки, пригодной для прямого распространения.Единственный способ получить видео: после status: "completed" вызовите GET /v1/videos/{task_id}/content, чтобы получить двоичный поток MP4 (требуется заголовок Authorization: Bearer).Стандартный production-паттерн:
  1. Бэкенд скачивает MP4 сразу после завершения задачи → загружает в ваш собственный OSS / CDN
  2. Отдавайте пользователям ваш CDN URL
  3. Тег <video> на frontend НЕ должен указывать напрямую на /content — браузеры не могут передать заголовок авторизации, запросы будут 401
Если/когда upstream начнет отдавать CDN URLs, эта страница будет обновлена.
Срок хранения официально не документирован. Настоятельно рекомендуется: скачивайте сразу после завершения и храните локально — не полагайтесь надолго на удаленный task_id; /content после истечения срока в итоге вернет 404.
Поле progress слишком грубое — оно прыгает только между 0 / 50 / 100. Не используйте его для индикатора прогресса в процентах. Используйте spinner или вычисляйте «прошло / ожидается» сами.
Нет. Оплачиваются только задачи status=completed. failed / отмененные / отклоненные по content-policy / ошибка параметров — все бесплатно. Нет реального видеовывода — нет оплаты.
Не побайтно идентичные. По измерениям: тот же prompt + тот же seed (88888) + те же параметры, fast дважды — размеры файлов 9.81 MB и 9.25 MB, md5 полностью различается, время рендеринга тоже отличается.Но seed не декоративен: результаты с одинаковым seed группируются вместе (тест на 5 запусков, разброс размеров файлов внутри группы всего 6%), разные seed систематически смещаются (межгрупповой разброс +36.8%). Выводы:
  • Нужен «стабильный вид» → зафиксируйте seed
  • Нужно «исследовать вариации» → меняйте seed, а не возитесь с prompt
  • Нужен «точный повтор» → забудьте об этом, сохраняйте mp4
Пока не поддерживается ни то ни другое. Image-to-video принимает только 1 изображение, имя поля фиксировано как input_reference, и только как file или Base64, а не удаленный URL.Google upstream Veo 3.1 поддерживает multi-reference / first-last-frame / video extension, но этот канал — нет. Для первого/последнего кадра используйте серию VEO 3.1 (Reverse) -fl.
При 10 одновременных отправках все были успешно поставлены в очередь — отклонений не было. Точный предел публично не указан. Рекомендуется ограничить in-flight на стороне продакшена до ≤ 10, с exponential backoff при 429 / 5xx.
  • Видимых водяных знаков нет
  • Но они содержат Google C2PA Content Credentials (выданы Google C2PA Media Services, формат urn:c2pa:...), встроенные в метаданные MP4. Конечные пользователи их не видят; инструменты C2PA (например, Adobe Content Authenticity) могут проверить «сгенерировано Veo»
  • Для сценариев перераспространения учитывайте это; обычно на воспроизведение не влияет
Частично. Интерфейс следует соглашениям OpenAI (Bearer auth + /v1/...), но официальный SDK OpenAI не предоставляет метод videos.create (/v1/videos — это custom path). Используйте низкоуровневый client.post() в SDK OpenAI или raw HTTP. Raw HTTP — самый простой вариант — см. примеры кода в Песочница Text-to-Video.

​
Связанные документы

VEO 3.1 Official — это стабильный сервис APIYI с официальным реле — прозрачный passthrough к Google AI Studio. Идентификаторы моделей, поля ответов и ограничения полностью совпадают с upstream Google, а канал работает в группе Default с тарификацией pay-per-request — это самый бесшовный канал официального качества из доступных. Пожалуйста, отправляйте отзывы на панели поддержки в консоли.