Авторизация
API-ключ создаётся в кабинете и начинается с gk_sk_. Оба текстовых маршрута принимают Bearer token; Anthropic Messages также принимает x-api-key.
OpenAI-совместимый заголовок
Authorization: Bearer YOUR_API_KEY
Anthropic-совместимые заголовки
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
Доступ к моделям
- Ключ работает только пока он активен, не истёк и не исчерпал квоту.
- Если для ключа выбран ограниченный список моделей, остальные вернут HTTP 403.
- Один ключ можно использовать с несколькими разрешёнными моделями.
- Для production, разработки и CI лучше создавать разные ключи с отдельными квотами.
Безопасность
Храните ключ только на сервере или в менеджере секретов. Не вставляйте его в клиентский JavaScript, мобильное приложение, репозиторий, скриншот или обращение в поддержку. Удалите ключ в кабинете, если он мог утечь.
| HTTP | Причина |
|---|---|
| 401 | ключ отсутствует или неизвестен |
| 403 | ключ отключён, истёк, ограничен по IP или модели |
| 429 | исчерпана квота ключа или лимит шлюза |