Аутентификация и API-ключи
Аутентификация запросов через API-ключ GonkaGate.
Используйте GET /v1/models как первую auth-проверку GonkaGate до того, как разбирать тело запроса. Ответ 200 OK означает, что Bearer-заголовок принят, ключ проходит текущую проверку доступа, и запрос дошёл до каталога моделей.
Проверьте ключ одним запросом
- Если ключа ещё нет, войдите в аккаунт и откройте панель → API-ключи, чтобы создать его.
- Сохраните полный секрет, когда GonkaGate покажет его.
- Передайте его в заголовке
Authorization:
export GONKAGATE_API_KEY="gp-your-api-key"
curl https://api.gonkagate.com/v1/models \
-H "Authorization: Bearer $GONKAGATE_API_KEY"Ожидаемый результат: 200 OK со списком моделей.
Используйте этот запрос как быструю первичную auth-проверку, а не как полный диагноз по ключу. 429 insufficient_quota относится к тарифицируемым маршрутам вроде POST /v1/chat/completions, а 503 service_unavailable здесь означает временную недоступность каталога моделей, а не ошибку в Bearer-заголовке.
Формат Bearer-заголовка
Authorization: Bearer gp-your-api-keyХраните ключ в серверной среде или в менеджере секретов. Не добавляйте его в код браузера, мобильных приложений или публичные репозитории.
Как хранить и ротировать ключ
- Сохраните полный секрет в момент показа, потому что позже GonkaGate не раскрывает его повторно.
- Храните ключ вне репозитория и исходников, лучше в переменных окружения или менеджере секретов.
- Ротируйте ключ без простоя: сначала создайте новый, переведите трафик, затем отключите старый.
- Если есть риск, что ключ был раскрыт, перестаньте его использовать и сразу ротируйте.
Частые ответы при первой проверке ключа
Нужен точный диагностический ответ по текущему ключу? Используйте проверку API-ключа WhoAmI.
См. также
- Быстрый старт, чтобы отправить первый запрос
chat.completionsпосле успешной аутентификации. - Обработка rate limits для текущих
/v1лимитов запросов, токенов и concurrency. - Обработка ошибок API в GonkaGate, чтобы понять, когда запрос можно повторить, а когда нужно остановиться после успешной проверки аутентификации.
- Страница цен, если проблема на самом деле в
insufficient_quota, а не в неверной аутентификации.
