Доступ к Veo API кажется простым, если смотреть только на название модели. В production это видеопроцесс с проверками жизненного цикла модели, тарификацией за секунду, асинхронными операциями, выбором разрешения, стоимостью повторных попыток и наблюдаемостью на уровне маршрутов. Если ваша команда сравнивает Veo с Seedance, маршрутами в стиле Sora или другой видеомоделью за одним шлюзом, рассматривайте доступ как чек-лист, а не как замену API в одну строку.
Это руководство было проверено 17 июня 2026 года по времени Asia/Shanghai на основе документации Veo video Gemini API от Google, таблицы цен Veo 3.1 от Google, свежего прогона Ahrefs MCP и актуального снимка каталога цен Flatkey. Цель не в том, чтобы утверждать, что каждый маршрут сегодня готов к production. Цель в том, чтобы показать, что именно нужно проверить, прежде чем отправлять оплачиваемые видеозадания через мультивендорный роутер.
Краткий ответ: что проверить для доступа к Veo API
Перед одобрением доступа к Veo API для production-трафика проверьте эти семь пунктов:
- Официальный ID модели: решите, нужен ли рабочему процессу
veo-3.1-generate-preview,veo-3.1-fast-generate-previewилиveo-3.1-lite-generate-preview. - Статус жизненного цикла: избегайте более старых ID Veo 3.0 и Veo 2.0, если только вы не выполняете краткую миграцию, потому что Google указывает их как отключаемые 30 июня 2026 года.
- Единица цены: нормализуйте Veo по секундам, разрешению и варианту, прежде чем сравнивать его с провайдерами видео на основе токенов/ресурсных пакетов.
- Путь асинхронной задачи: записывайте имя операции, статус опроса, итоговое количество видео, длительность, разрешение, число повторных попыток и причину сбоя.
- Строка каталога Flatkey: проверьте точную строку модели, семейство endpoint, группу, ценовую метку и статус доступности в день маршрутизации трафика.
- Правило fallback: решите, когда неудачная задача Veo может переключиться на другой маршрут, а когда она должна завершиться с ошибкой из-за требований к качеству или бюджету.
- Подтверждение использования: выполните небольшой тест и убедитесь, что в панели управления отображаются выбранная модель, маршрут, статус, биллинговая единица и владелец затрат.
Это практическая версия доступа к Veo API: не просто «могу ли я вызвать Veo», а «могу ли я доказать, какой видео-маршрут был выполнен, сколько он стоил и что происходит, когда он не срабатывает».
Контрольный список доступа к Veo API
| Пункт контрольного списка | Почему это важно | Что сохранить в качестве доказательства |
|---|---|---|
| ID модели | Варианты Veo не взаимозаменяемы по стоимости, задержке, разрешению или поддержке маршрутов. | Официальный ID модели Google и соответствующая строка Flatkey. |
| Семейство конечных точек | Маршрут для видео может вести себя не так, как завершение чата, даже если шлюз предоставляет интерфейс, совместимый с OpenAI. | Тип конечной точки, шаблон запроса, принимаемые параметры и форма ответа. |
| Единица тарификации | Veo указывается за секунду, тогда как другие видеопровайдеры могут использовать токены, сгенерированные медиафайлы или пакеты ресурсов. | Вариант, разрешение, ожидаемая длительность в секундах, политика повторных попыток и дата источника цены. |
| Логирование асинхронных операций | Генерация Veo использует поток отправки и опроса, поэтому одно действие пользователя может создавать несколько внутренних событий. | ID операции, попытки опроса, итоговый статус, метаданные сгенерированного видео и количество повторных попыток. |
| Статус доступности | Строка в каталоге — это не то же самое, что успешный маршрут в продакшене. | Статус в панели, время последней проверки, тестовый ответ и запись в журнале использования. |
| Граница fallback | Переключение видеомоделей может изменить стиль, длительность, качество, поведение политик и стоимость. | Одобренная матрица fallback и условия fail-closed. |
Подтвердите официальную модель Veo и жизненный цикл
В документации Google Gemini API в примерах генерации Veo в настоящее время используется veo-3.1-generate-preview. В таблице цен перечислены три предварительных идентификатора Veo 3.1: veo-3.1-generate-preview, veo-3.1-fast-generate-preview и veo-3.1-lite-generate-preview. Это первое место, с которого следует начать проверку доступа к Veo API, потому что каталог шлюза может одновременно содержать старые идентификаторы, псевдонимы и метки, специфичные для провайдера.
Не менее важен и жизненный цикл, чем текущий идентификатор. На странице цен Google, проверенной для этой статьи, указано предупреждение, что модели Veo 3 veo-3.0-generate-001 и veo-3.0-fast-generate-001 устарели и запланированы к отключению 30 июня 2026 года. Также говорится, что Veo 2 veo-2.0-generate-001 устарела и запланирована к тому же отключению 30 июня 2026 года. Если старый пример кода, сохраненный маршрут или избранное на панели управления по-прежнему указывает туда, рассматривайте это как задачу миграции, а не как путь с подтвержденным доступом.
Нормализуйте цены Veo API, прежде чем сравнивать варианты маршрутизации
Для доступа к Veo API указывать цену в заголовке полезно только после нормализации запроса. Текущие тарифы Google Veo 3.1 для платного уровня указаны в USD за секунду, с разными строками для вариантов Standard, Fast и Lite.
| Вариант Veo 3.1 | Официальный ID модели | Проверенная цена | Примечание для планирования |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
$0.40/сек при 720p или 1080p; $0.60/сек при 4K. | Используйте, когда требования к качеству оправдывают более дорогую строку по умолчанию. |
| Fast | veo-3.1-fast-generate-preview |
$0.10/сек при 720p; $0.12/сек при 1080p; $0.30/сек при 4K. | Проверьте качество вывода и задержку, прежде чем направлять сюда пользовательские задания. |
| Lite | veo-3.1-lite-generate-preview |
$0.05/сек при 720p; $0.08/сек при 1080p; 4K не поддерживается. | Полезно для более дешёвых черновиков, когда 4K не требуется. |
На странице цен Google также указано, что плата взимается только в случае успешной генерации видео. Это не отменяет необходимости вести журнал повторных попыток. Сбой операции, изменённый запрос или повторный запуск по просьбе пользователя всё равно могут позже создать ещё одно платное задание. В ваш контрольный список для доступа к Veo API должны входить длительность, разрешение, вариант, статус успеха и количество повторных попыток для каждого запроса.
Если вы сравниваете Veo с другими провайдерами, используйте более широкий сравнительный анализ цен API для генерации видео с помощью ИИ как центр нормализации. Не сравнивайте строку Veo с ценой за секунду напрямую с провайдером, который работает на основе токенов или пакетов ресурсов, без перевода в фактическую форму запроса.
Рассматривайте генерацию Veo как длительную операцию
Руководство Google по Veo показывает поток длительной операции: отправьте запрос на генерацию, опрашивайте операцию, пока она не завершится, затем получите сгенерированное видео. Это делает доступ к API Veo отличным от обычного текстового запроса с одним ответом. Вашему маршрутизатору и панели управления нужно сохранять состояние задачи между опросами, а не просто фиксировать первый HTTP-вызов.
Журнал, готовый к работе в продакшене, должен отвечать на такие вопросы:
- Какое приложение, ключ команды, окружение и рабочий процесс создали задачу на видео?
- Какой ID модели Veo, соотношение сторон, разрешение, тип запроса и входные медиа были использованы?
- Какой ID операции или эквивалентный асинхронный хэндл был возвращен?
- Сколько попыток опроса было выполнено до завершения или сбоя?
- Задача была успешной, завершилась с ошибкой, отменена, повторена или перенаправлена куда-то еще?
- Сколько сгенерированных видео было возвращено и где был сохранен результат?
- С какой записью использования и записью затрат финансы смогут свериться позже?
Это также место, где совместимость endpoint нужно проверить по-настоящему. Шлюз может предоставлять OpenAI-совместимый базовый URL для многих семейств моделей, но у генерации видео часто есть специфичные для провайдера поля и асинхронная семантика. Используйте фрагменты кода как шаблоны, пока не протестируете актуальный ключ Flatkey, актуальную строку модели Veo и точное тело запроса, которое будет использовать ваше приложение.
Проверьте строки каталога Flatkey перед запуском в продакшн
Публичный прайсинг-каталог Flatkey был проверен для этой статьи 17 июня 2026 года, Asia/Shanghai. Ответ содержал 638 строк моделей и версию прайсинга a42d372ccf0b5dd13ecf71203521f9d2. Были найдены строки, связанные с Veo, включая идентификаторы в стиле Google и алиасы, такие как veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview, veo3.1, veo3.1-fast и veo3.1-pro.
Важная оговорка: у каждой строки Veo, проверенной в этом снимке, статус доступности был unknown_failure. Это означает, что статью можно использовать как датированное доказательство наличия строк в каталоге, но нельзя утверждать, что они готовы для реальной работы в продакшне. Правильный workflow для Veo API access — открыть текущую страницу прайсинга Flatkey, подтвердить точную строку, проверить метку в дашборде, проверить семейство endpoint'ов и запустить небольшой smoke-тест перед отправкой продакшн-трафика.
| Проверенная строка Flatkey | Типы endpoint'ов, которые были найдены | Поля прайсинга, которые были найдены | Статус в снимке |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
Публичный продуктовый текст Flatkey поддерживает осторожный сценарий маршрутизации: один API-ключ, понятный прайсинг, единый биллинг, дашборд для ключей, использования и маршрутизации, а также язык про автоматическое переключение/балансировку нагрузки. Оставляйте доказательство реализации более узким, чем маркетинговое обещание. Для Veo API access acceptance-тест должен быть реальной записью запроса, подтвержденной в дашборде, а не только строкой каталога.
Настройте правила видеомаршрутизации с несколькими провайдерами
Отказоустойчивость видео более чувствительна, чем отказоустойчивость текста. Если задание Veo завершается сбоем, переход к другому провайдеру может изменить длительность, визуальный стиль, интерпретацию промпта, фильтры контента, формат вывода и цену. План Veo API access должен определять, когда автоматический переход на резервный вариант безопасен, а когда рабочий процесс должен остановиться для проверки человеком.
| Ситуация | Рекомендуемое решение по маршрутизации | Причина |
|---|---|---|
| Временная ошибка провайдера или тайм-аут | Повторите попытку один раз или переключитесь на одобренный эквивалентный маршрут, если рабочий процесс это допускает. | Защищает пользовательский опыт, не скрывая повторяющиеся сбои. |
| Устаревший ID модели | Заблокируйте маршрут и перейдите на актуальную модель до запуска производственного трафика. | Предотвращает скрытую зависимость от маршрута с фиксированной датой отключения. |
| Неподдерживаемый параметр запроса | Завершите с ошибкой и исправьте запрос клиента. | Слепой переход на резервный вариант обычно повторяет тот же неверный запрос в другом месте. |
| Финальный рендер в высоком разрешении | Требуйте явного одобрения для перехода на более дорогой маршрут. | Разрешение и длительность быстро увеличивают стоимость видео. |
| Черновик или внутренняя творческая итерация | Разрешайте менее дорогой резервный вариант только если различия в результате приемлемы. | Рабочие процессы с черновиками могут допускать больше вариативности, чем результат для клиента. |
Сторона надежности этого решения более подробно рассматривается в руководстве по балансировке нагрузки и отказоустойчивости AI API. Для видео добавляйте ограничения по стоимости и по творческому результату в каждую схему резервного перехода.
Запустите этот smoke-тест перед запуском
Ответственный smoke-тест доступа к Veo API должен быть небольшим, контролируемым и простым для проверки:
- Создайте или выберите нерабочий ключ Flatkey.
- Выберите одну актуальную строку Veo на странице с живыми ценами и зафиксируйте ее точную метку модели.
- Подтвердите семейство endpoint и шаблон запроса с владельцем продукта/документации.
- Запустите одну малорискованную видео-задачу с известными настройками длительности и разрешения.
- Сохраните ID операции, путь опроса статуса, конечный результат, расчетную единицу и запись в журнале использования.
- Повторите с одним контролируемым сбоем, где это возможно, например с заблокированной устаревшей моделью или неподдерживаемым параметром.
- Решите, может ли маршрут обслуживать production-трафик, только staging или только исследовательский backlog.
Если любой из этих проверок не проходит, не выводите маршрут в production. Отсутствующий журнал использования, неясная единица ценообразования или статус доступности unknown_failure — это не вопрос оформления для видео; это влияет на стоимость, поддержку и ожидания клиентов.
Часто задаваемые вопросы
Как получить доступ к Veo API?
Начните с текущей документации Google Gemini API по Veo и требований к оплате, затем проверьте идентификатор модели, конечную точку и цены в день разработки. Если вы используете Flatkey для маршрутизации, проверьте текущий каталог цен и панель управления, прежде чем считать доступ к Veo API готовым к эксплуатации.
Какой идентификатор модели Veo следует использовать?
В текущей таблице цен Google для Veo 3.1 указаны veo-3.1-generate-preview, veo-3.1-fast-generate-preview и veo-3.1-lite-generate-preview. Избегайте старых идентификаторов Veo 3.0 и Veo 2.0 для новых производственных задач, поскольку Google указывает их как подлежащие отключению 30 июня 2026 года.
Как рассчитывается цена Veo API?
Google указывает цены платного уровня Veo 3.1 за секунду, с разными тарифами в зависимости от варианта и разрешения. Для доступа к Veo API нормализуйте ожидаемую длительность в секундах, разрешение, политику успешного выполнения и повторы перед сравнением маршрута с поставщиками видео на основе токенов или ресурсных пакетов.
Можно ли маршрутизировать Veo вместе с другими моделями генерации видео?
Да, но только после определения контракта маршрута. Переход с Veo на другую видеомодель может изменить визуальное качество, длительность, формат вывода, поведение модерации и стоимость. Используйте утверждённые правила резервного перехода, а не общие автоматические повторы.
Что следует проверить пользователям Flatkey перед запуском в продакшен?
Проверьте текущую строку модели, семейство конечных точек, метку на панели управления, статус доступности, ценовую метку, поля журнала использования и реальный результат smoke-теста. В снимке от 17 июня 2026 года, использованном для этой статьи, строки Veo существовали, но показывали unknown_failure, поэтому для производственного использования требуется свежая проверка.
Итоговый вывод
Доступ к Veo API — это решение для production, а не просто галочка у провайдера. Подтвердите официальную модель, нормализуйте секунды и разрешение, обрабатывайте асинхронные задания, проверяйте актуальную строку Flatkey и данные на дашборде, а также задокументируйте границы fallback-режимов до первого клиентского запроса на видео.
Чтобы оценить Veo вместе с остальным стеком видеомоделей, начните с актуального каталога тарифов Flatkey и используйте приведённый выше чек-лист, чтобы определить, какие маршруты готовы для staging, какие требуют smoke test, а какие стоит оставить в исследовательском backlog.
