Разделы документации

Аутентификация

Bearer token, формат API-ключа и заголовок Authorization.

Все relay-запросы к /v1/* требуют валидный API-ключ пользователя TokenDock.

Заголовок

Authorization: Bearer YOUR_API_KEY

Клиенты OpenAI обычно принимают ключ в поле «API Key» — gateway сам добавит заголовок Authorization.

Где взять ключ

  1. Регистрация или вход
  2. API-ключи → создать ключ
  3. Скопировать и хранить в секретах (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.