Аутентификация
Как передавать ключ, какой заголовок ожидает каждый формат и как обеспечить безопасность ключей.
Для каждого запроса нужен ключ API, созданный в панели управления. Ключи начинаются с sk- и используют разрешения и баланс аккаунта, в котором они созданы.
Два заголовка, один ключ
Один и тот же ключ работает в обоих форматах — меняется только имя заголовка.
| Формат | Эндпоинт | Заголовок |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
Формат Anthropic также требует заголовок версии. Любой SDK Anthropic задаёт его автоматически:
-H "anthropic-version: 2023-06-01"Переменные окружения
Большинство инструментов считывает эти переменные, а не принимает ключ в качестве аргумента:
| Переменная | Используется в | Значение |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code, SDK Anthropic | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | ваш sk- ключ |
ANTHROPIC_API_KEY | SDK Anthropic (Python/TS) | ваш sk- ключ |
OPENAI_BASE_URL | SDK OpenAI, LangChain, LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | SDK OpenAI | ваш sk- ключ |
Обратите внимание на поле
/v1 суффикс у OPENAI_BASE_URL но не у ANTHROPIC_BASE_URL. Эта асимметрия заложена в официальных SDK, а не введена нами: клиент OpenAI добавляет пути к указанному вами базовому адресу, а клиент Anthropic добавляет /v1 самостоятельно. Ошибка в этом месте — самая частая ошибка настройки.Безопасное обращение с ключами
- Создайте отдельный ключ для каждой машины или проекта чтобы один ключ можно было отозвать, не затрагивая остальные.
- Никогда не сохраняйте ключи в коммитах. Используйте переменные окружения или менеджер секретов; добавьте
.envна.gitignore. - Ключи показываются полностью только один раз. Вместо попыток восстановить потерянный ключ создайте новый взамен старого.
- Утёкший ключ позволяет расходовать ваш баланс. Немедленно отзовите его в панели управления — отзыв вступает в силу сразу.
- Предпочитайте вызовы на стороне сервера. Ключ, включённый в браузерную сборку или мобильное приложение, становится общедоступным.
Отзыв и ротация ключей
- Панель управления → Ключи API.
- Сначала создайте новый ключ и внедрите его.
- Удалите старый ключ после переключения трафика. Выполняющиеся запросы с этим ключом завершатся ошибкой сразу после его удаления.