API429 / Разработчикам

Gemini API из России: от ключа до первого запроса

API429 — независимый шлюз для подключения Gemini к приложениям и автоматизациям. Вы создаёте ключ API429 и отправляете запросы на единый адрес API через OpenAI-совместимый интерфейс.

Какой доступ вы получаете

Ключ API429 используется с адресом https://gateway.api429.com/v1. Это отдельный сервис со своим балансом и условиями: ключ не предназначен для входа в Google AI Studio или оплаты подписки Gemini. Прямой доступ к Google регулируется списком поддерживаемых регионов Google.

Шлюз подходит разработчикам Telegram-ботов, веб-приложений и сценариев n8n, которым нужен программный вызов модели. Если вам нужен только чат в браузере, сначала посмотрите Studio. Для оценки API сравните модели и их возможности с требованиями приложения.

Как получить ключ и подключить Gemini

  1. Зарегистрируйтесь в личном кабинете API429. Создайте API-ключ и храните его в переменных окружения сервера или в хранилище credentials вашего инструмента.
  2. Откройте пополнение баланса. Выберите доступный способ оплаты; валюту, сумму, комиссию и итог проверяйте в форме перед подтверждением платежа.
  3. Выполните GET https://gateway.api429.com/v1/models с заголовком Authorization: Bearer ВАШ_КЛЮЧ. Выберите точный ID доступной текстовой модели Gemini.
  4. Настройте base URL, ключ и модель в клиенте. Начните с одного короткого запроса, затем проверьте ответ и списание в кабинете.

Пошаговая настройка узла HTTP Request и готовое тело запроса — в инструкции для n8n. Контракт запросов опубликован в документации API429.

Как оплатить Gemini API и оценить расходы

Вы пополняете баланс API429, из которого оплачивается использование моделей. Доступные платёжные варианты могут меняться: проверяйте их в своём кабинете. Если нужный способ не отображается, уточните его у поддержки до перевода средств.

Стоимость зависит от модели, объёма входа и ответа, а для изображений — также от размера и способа тарификации. На странице цен Gemini API приведены актуальные ставки и пример расчёта. Подписку на пользовательский чат нельзя считать бюджетом API.

Что проверить перед запуском бота

  • Модель присутствует в списке именно вашего ключа, а нужный метод поддерживается.
  • Секретный ключ не попадает в клиентский JavaScript, логи или экспорт workflow.
  • Для параллельных запросов установлены ограничения; ошибки 429 и таймауты обрабатываются отдельно от ошибок авторизации.
  • Бюджет учитывает ответы модели и повторные попытки. Наличие шлюза не отменяет лимиты провайдеров.

Частые вопросы

Можно ли использовать существующий OpenAI-клиент?

Для поддерживаемых методов — да: измените base URL, ключ и ID модели. Специальные функции Google могут требовать других параметров; сверяйте их с документацией, а не только с названием модели.

Что делать, если модель не найдена?

Повторно получите список через /v1/models и проверьте точное написание ID. Не подставляйте название из старой статьи. Для генерации картинок используйте отдельную инструкцию Nano Banana API.

Telegram