Veo API в России

Veo в России: где купить доступ к Veo API

Ролики Veo продаёт GEN202, и порядок укладывается в три шага: вход, пополнение баланса и выпуск ключа в кабинете. Между оплатой и первым роликом нет ни заявки, ни проверки документов.

Оплата идёт рублями с карты российского банка, и валюта в этой цепочке не появляется вовсе. За секунду готового ролика берут от 4,5 ₽ до 54 ₽, а место в этой вилке выбираете вы сами — уровнем и разрешением.

Сумма за ролик известна ещё до запуска и по ходу работы не растёт: её задают три величины из вашего же запроса — уровень, разрешение и число секунд. Все сочетания собраны в ценах модели. Счёт внутри сервиса идёт кредитами, а покупают их готовыми пакетами: самый маленький стоит 500 ₽ и приносит 1 000 кредитов.

Три уровня оплачиваются с одного счёта, и выбор между ними ничего не меняет в порядке покупки. Помесячной платы за доступ к модели нет — с баланса уходит стоимость снятых роликов. Кредиты ложатся на счёт сразу после оплаты, и включать что-либо после этого не надо.

Что входит в Veo: 3 уровня одной модели

Под именем Veo продаются Veo 3.1 Lite, Veo 3.1 Fast и Veo 3.1 Quality. Работа у них общая — снять короткий ролик и записать к нему звук, — от 4 до 8 секунд, с разрешением вплоть до 4k.

Ту же самую модель Google раздаёт и в своих службах: в студии разработчика, в облаке и в приложениях для работы. К нам она приходит без переделок. Что переменилось в этом поколении, Google называет сам: богаче стал родной звук, точнее — следование написанному, а герой лучше держит облик от сцены к сцене.

Вызов с примерами на curl и Python лежит в разделе «Veo». Про выпуск прошлого поколения — что он умел и почему по его имени отвечает нынешний — написано на странице Veo 3.

Что Veo принимает в запросе и каким выходит ролик

Обязательное поле здесь одно — описание словами; остальные шлюз подставит за вас. Уровень ставится полем model, и имена у него такие: veo/3-lite, veo/3-fast и veo/3. Без этого поля уйдёт veo/3-fast — тот уровень, который шлюз подставляет по умолчанию.

Длительность выбирают из 3 значений: 4, 6 и 8 секунд. Разрешений тоже 3 — 720p, 1080p и 4k, и без явного значения уйдёт 720p. Продаются не все сочетания: у veo/3-lite в 4k официальной цены нет, и такой запрос шлюз отклоняет.

Картинки приходят одним списком imageUrls, и берёт он до 3 ссылок. Как их прочитать, говорит поле generationType: развернуть ролик вокруг одной, взять две крайними кадрами или собрать по образцам. Звук Google записывает вместе с картинкой, и отдельного действия на озвучку не предусмотрено.

Набор полей у Veo 3.1 Lite, Veo 3.1 Fast и Veo 3.1 Quality общий, поэтому переход между ними — правка одного значения. Расходятся у них цена секунды и набор продаваемых сочетаний, а не форма вызова. Каждое поле по отдельности разобрано в разделе «Veo».

Ссылки в imageUrls проверяются теми же правилами, что и у остальных моделей каталога. Адрес нужен полный, на http или https, и открываться он должен снаружи без имени и пароля. Картинку с диска превращает в такой адрес загрузка, показанная в разделе «Загрузка своих файлов».

Как выпустить ключ для Veo API

Всё, что требуется, — это вход на сайт: ключ появляется в кабинете по нажатию и сразу принимается шлюзом. Ключей держат сколько нужно, а имя каждому придумывают своё — длиной до 60 знаков.

Второй ключ под видео заводить не придётся: этим же вызывается остальной каталог — и картинки, и языковые модели. Каким заголовком ключ уходит на сервер, показано в разделе «Ключ и заголовки».

Расход по ключу виден в кабинете, а спросить его из программы позволяют адреса раздела «Баланс и расход». Отозванный ключ перестаёт приниматься сразу же, и другие ключи счёта работают как работали.

Свои адреса Veo API: как ставится задача и как забирается ролик

Вызывается Veo не общей командой каталога, а двумя собственными адресами. Путь от постановки задачи до готового файла проходит через пять шагов, и одинаков он у всех трёх уровней.

1. Постановка. Задача ставится запросом на https://api.gen202.com/api/v1/veo/generate, и в ответ приходит её номер.
2. Опрос. Готовность спрашивают у /api/v1/veo/record-info, передав этот номер параметром.
3. Поле successFlag. Состояние приходит не словом, а числом: ноль означает, что работа идёт, единица — что ролик готов.
4. Ссылка на ролик. При единице адрес файла лежит в поле response, и переписывать по дороге его никто не берётся.
5. Неудача. Двойка и тройка означают неудачу, а объяснение к ней приходит полем errorMessage.

Открывается ссылка 14 дней — столько готовый ролик хранится на той стороне. Значит, забирать файл к себе лучше сразу, а не держать чужой адрес в своей базе.

Ключ передаётся заголовком Authorization в обоих запросах, и он же открывает остальной каталог. Отдельного потолка частоты адреса Veo не накладывают. Остальные правила работы — размер тела, сроки и журнал вызовов — собраны в разделе «Лимиты и эксплуатация».

Крайний срок у задачи — 60 минут, и он тот же, что у прочего видео. Расчёт закрывается тем самым опросом, который увидел итог: списание при готовности и возврат при неудаче. Пока состояние не спрошено, деньги остаются отложенными, а по истечении срока шлюз отпускает их сам.

Готовая операция приносит адрес файла, а не сам файл, и это чаще всего и удивляет при первом вызове. Ролик забирают отдельным скачиванием по этому адресу, и делать это лучше сразу.

Почему цена ролика Veo известна до запуска

Счёт складывается из трёх величин, и все три называете вы сами: уровень, разрешение и длительность. Ставка за секунду у каждого сочетания своя, а число секунд берётся из поля duration. Поэтому сумма считается до обращения к Google и по ходу работы не меняется.

Ровно эта сумма и откладывается на счёте: удержание здесь совпадает с ценой вызова. Готовый ролик списывает её целиком, и пересчитывать по факту нечего. Неудача снимает отложенное полностью, а списанным по такой задаче остаётся ноль.

Дешевле всего секунда обходится в 4,5 ₽, дороже всего — в 54 ₽. Все сочетания уровня и разрешения собраны в ценах модели. Сочетание без официальной цены шлюз не продаёт и отвечает отказом 422.

Свободных кредитов меньше цены ролика — задача не заводится, приходит 402. Короткий ролик в 720p требует меньше, поэтому проходит и на небольшом остатке. Как спросить баланс и расход из программы, показано в разделе «Баланс и расход».

Что отвечает шлюз, когда ролик Veo не получился

Отказ приходит либо на постановку задачи, либо на опрос состояния, и конверт ответа у обоих один. Всё, что шлюз проверяет у себя, отбивается до обращения к Google и денег не стоит.

• 401 — ключа в заголовке нет либо он отключён.
• 422 — пустое описание, значение вне списка, непринятая ссылка или непродаваемое сочетание.
• 402 — свободных кредитов меньше известной цены ролика.
• 502 — поставщик не ответил или ответил ошибкой.
• 503 — поставщик перегружен, а срок повтора называется заголовком Retry-After.
• 404 — номера не нашлось либо задача под ним заведена другим счётом.
• 502 и 503 — состояние узнать не вышло, и расчёт остаётся незакрытым.

Денег ни один из этих ответов не стоит: на постановке отложенное снимается сразу, на опросе расчёт остаётся незакрытым. Перечень отказов целиком вместе с пояснениями стоит в разделе «Отказы».

Отказ по правилам поставщика приходит не поломкой: работа заканчивается, а ролика в ответе не оказывается. Здесь такой итог виден числом состояния, объяснение лежит в errorMessage, и удержанное возвращается целиком. Обычный выход из него — поправить описание и поставить задачу заново.

Нужен ли аккаунт Google Cloud, чтобы вызвать Veo

Нет. Для вызова Veo ни ключа Google, ни проекта в его облаке не потребуется: к нему ходит наш шлюз и своим ключом, а с вашей стороны расход считается кредитами.

Можно ли купить у нас ключ Google для Veo

Ключи Google выдаёт он один и только сам. Торгуем мы вызовами: запрос приходит на наш адрес, а дорогу до Google он проходит нашими руками.

Ваш собственный ключ отзывается одним нажатием, а невыработанные кредиты никуда не пропадают.

Есть ли бесплатная генерация в Veo API

Ролик оплачивается по расходу, и на первый хватает приветственных кредитов. Первый вход приносит 50 кредитов, а по самой дешёвой ставке из них выходит 5 секунд видео.

Сколько кредитов уйдёт, видно ещё до нажатия: песочница считает сумму по выбранным полям. Неудавшийся ролик денег не стоит — удержанное возвращается на счёт целиком.

Где Google проводит границу применения Veo

Правила использования у Google одни на всю его линейку, и Veo подчиняется им наравне с остальными моделями. Встраивать модель нельзя в то, что нарушает закон или ведёт опасное дело, ломает чужие службы, делает непристойное, жестокое или разжигающее вражду, а также вводит людей в заблуждение.

Что запрещено с нашей стороны, записано в условиях сервиса.

Работать из России можно без VPN, а платить — рублями с карты российского банка. Прямой доступ идёт через биллинг поставщика, и счёт он выставляет в долларах. GEN202 стоит между вами и поставщиком: расчёты с ним наши, вы платите российскому продавцу.