Когда пора переходить на API
Пока задач немного, интерфейс удобнее: он ничего не требует настраивать. API нужен, когда появляется повторяемость.
Признаки: одну и ту же операцию делают десятки раз в день, результат должен попадать в вашу систему автоматически, обработка идёт по расписанию, или объём такой, что руками уже не успеть.
Порог считается просто: если ручная работа стоит дороже, чем разовая настройка интеграции, — пора. Подробнее этот расчёт — в сравнении API и интерфейса.
Что такое ключ
Ключ — это строка, которая подтверждает, что запрос ваш, и по которой списываются деньги. Он заменяет логин и пароль в автоматическом обмене.
Три правила обращения с ним одинаковы везде. Не публиковать: ключ в коде на публичном репозитории — типичный способ потерять деньги. Хранить в переменных окружения, а не в исходниках. Иметь возможность отозвать: скомпрометированный ключ должен выключаться одной кнопкой.
Раздел для разработчиков описывает, как получить ключ и что с ним делать дальше.
Лимиты: три разных ограничения
Их путают, а ведут они себя по-разному.
| Лимит | Что ограничивает | Что происходит при превышении |
|---|---|---|
| Баланс | Сколько всего можно потратить | Запросы перестают выполняться |
| Частота запросов | Сколько обращений в секунду | Ошибка, нужно повторить позже |
| Контекст модели | Сколько текста влезает в один запрос | Ошибка или обрезка входных данных |
Первый решается пополнением, второй — очередью и повторами на стороне вашего кода, третий — выбором модели с большим окном или разбиением задачи.
Один ключ вместо пяти счетов
Обычный путь выглядит так: аккаунт у одного поставщика для текста, у другого для картинок, у третьего для видео. Каждый со своей регистрацией, своим способом оплаты, своим форматом запросов и своим счётом.
Через ГПТ Россия это один ключ и один формат обращения к разным моделям — от Gemini 3.1 Pro до генерации изображений. Оплата российской картой, без VPN и без валютных карт.
Практическая выгода не только в удобстве бухгалтерии: переключить задачу с одной модели на другую становится изменением одного параметра, а не переписыванием интеграции.
Важная деталь про деньги: у API отдельный баланс для разработчика — он не общий с балансом веб-интерфейса. Приветственный бонус начисляется на веб-баланс, а API пополняется отдельно, минимальная сумма — 500 ₽. Цены по моделям одни и те же, они на странице тарифов.
Первый запрос
Начинайте не с интеграции, а с одного ручного запроса — убедиться, что ключ работает и ответ приходит в ожидаемом виде.
Дальше добавляйте по одному: обработку ошибок, повтор при превышении частоты, логирование, и только потом — свою бизнес-логику. Соблазн написать всё сразу заканчивается отладкой в темноте.
Полезный приём: попросите модель написать черновик интеграции. «Напиши на Python функцию, которая отправляет запрос к этому API, обрабатывает ошибки и повторяет при 429. Объясни каждый блок». Разбор кода при этом читать обязательно — подход описан в гайде про код для непрограммиста.
Как не переплатить
Считайте в токенах, а не в запросах. Токен — это примерно часть слова; платите вы за объём входа и выхода, а не за сам факт обращения.
Отсюда экономия: не отправляйте лишний контекст, ограничивайте длину ответа явно, а тяжёлые модели берите только там, где они нужны. Черновая обработка на экономичной модели и финальная на сильной обычно дешевле, чем всё подряд на сильной.
Частые вопросы
Нужно ли уметь программировать?
Для простых сценариев достаточно уметь читать код и запускать скрипт. Написать черновик поможет сама модель, но проверять, что он делает с вашими данными, придётся вам — особенно если скрипт что-то удаляет или перезаписывает.
Что делать при ошибке превышения частоты?
Повторять запрос с нарастающей паузой, а не сразу же. Немедленный повтор обычно упирается в тот же лимит; пауза в несколько секунд с удвоением при каждой неудаче решает проблему в большинстве случаев.
Можно ли протестировать API на приветственный бонус?
Нет. Бонус 50 ₽ начисляется на баланс веб-интерфейса, а API работает на отдельном балансе разработчика, который создаётся пустым. Минимальное пополнение для API — 500 ₽. Сами возможности моделей можно бесплатно оценить в веб-интерфейсе на приветственные 50 ₽, а ключ брать, когда решение уже принято.
