APIGrid
Получить ключ

Аутентификация и ключи

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

Как передавать ключ

Передавайте ключ в заголовке Authorization с префиксом Bearer:

curl
curl https://api.apigrid.cloud/v1/balance \
  -H "Authorization: Bearer $APIGRID_KEY"

Можно и в заголовке x-api-key — так его отправляют Anthropic SDK и Claude Code. Оба варианта равноценны:

curl
curl https://api.apigrid.cloud/v1/balance \
  -H "x-api-key: $APIGRID_KEY"

Без ключа, с неверным или отозванным ключом API ответит 401 unauthorized.

Ограничения ключа

Ограничения задаются при выпуске ключа или позже — кнопкой «Ограничения» на странице API ключи. Всё, что не задано, не ограничено.

Модели
Список моделей, к которым ключ может обращаться. Запрос к другой модели вернёт 403 forbidden.
IP-адреса
Адреса и подсети IPv4 и IPv6, например 203.0.113.5 или 10.0.0.0/24. Запрос с другого адреса вернёт 403 forbidden.
Запросов в минуту
Сколько запросов можно отправить с ключом за минуту. Если не задано — действует общий лимит, см. Лимиты. Сверх лимита — 429 rate_limited.
Лимит расхода в месяц
Сколько рублей ключ может потратить за календарный месяц (по UTC). Когда лимит исчерпан, новые задачи получают 403 forbidden до начала следующего месяца.

На одном аккаунте может быть до 20 активных ключей. Баланс у них общий.

Безопасность

  • Держите ключ на сервере. Не вставляйте его в код сайта, мобильного приложения или расширения — оттуда его легко достать.
  • Отдельный ключ на каждое приложение и окружение. Так проще ограничить права и найти, откуда идут запросы.
  • Ограничьте IP и расход. Даже утёкший ключ тогда не потратит больше заданного лимита.
  • Ключ утёк — отзовите его. Кнопка «Отозвать» на странице API ключи: ключ перестаёт работать сразу, запросы с ним получают 401.