Разделы документации
Аутентификация
Bearer token, формат API-ключа и заголовок Authorization.
Все relay-запросы к /v1/* требуют валидный API-ключ пользователя TokenDock.
Заголовок
Authorization: Bearer YOUR_API_KEY
Клиенты OpenAI обычно принимают ключ в поле «API Key» — gateway сам добавит заголовок Authorization.
Где взять ключ
- Регистрация или вход
- API-ключи → создать ключ
- Скопировать и хранить в секретах (env, password manager) — не публикуйте в Git
Ограничения ключа
В кабинете можно задать для ключа:
- лимит моделей (whitelist);
- срок действия;
- квоту расхода.
Если модель недоступна ключу, API вернёт ошибку — см. коды ошибок.
Другие форматы (Claude / Gemini clients)
Некоторые клиенты шлют ключ в других заголовках. Gateway нормализует их к Bearer:
| Клиент | Альтернатива |
|---|---|
| Anthropic | x-api-key + anthropic-version на /v1/models |
| Gemini | x-goog-api-key или query ?key= на /v1beta/models |
Для новых интеграций рекомендуем стандартный Bearer на /v1.
