Аутентификация
Каждый запрос подписывается API-ключом codexkey.
Формат API-ключа
sk_cdx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxПоддерживаемые заголовки аутентификации
Запросы в стиле Anthropic
Используйте x-api-key:
bash
curl https://api.codexkey.ru/v1/messages \
-H "x-api-key: sk_cdx_YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hi"}]
}'Запросы в стиле OpenAI
Используйте Authorization: Bearer:
bash
curl https://api.codexkey.ru/v1/chat/completions \
-H "Authorization: Bearer sk_cdx_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hi"}]
}'Подойдёт любой из двух способов. Шлюз смотрит сначала x-api-key, потом Authorization: Bearer.
Управление по ключу
В разделе Панель управления > API-ключи выбирается один из трёх вариантов: Premium, Cheap или Cheap + резервный Premium. Новый ключ получает Premium по умолчанию. Канал записан в самом ключе, поэтому переключение вкладки в каталоге уже созданный ключ не затрагивает.
| Настройка | Что делает |
|---|---|
| Название | Помогает найти ключ в личном кабинете |
| Premium | channel=premium, fallback_premium=false. Режим по умолчанию. |
| Cheap | channel=cheap, fallback_premium=false. Запросы идут только через канал Cheap. |
| Cheap + резервный Premium | channel=cheap, fallback_premium=true. Провайдер вправе отправить запрос в Premium по своим правилам каналов; тогда может действовать цена Premium. |
| Срок действия | expires_at задаёт дату окончания в будущем; для ключа без срока поле при создании не передают |
| Расход | Здесь видны недавние запросы, токены и клиентская стоимость. Бюджеты, IP-фильтры, ограничения по IDE и по моделям через этот API для ключа не задаются. |
| Стриминг | Ответ идёт потоком, если клиент передал "stream": true; для обычного ответа укажите "stream": false |
Советы по безопасности
- Заведите отдельные ключи для личных задач, приложений и автоматизации
- Ключи, которыми вы больше не пользуетесь, удаляйте
- Если запросы через Premium не нужны, выберите Cheap без резерва
- Для временных интеграций задавайте срок действия
- Расход по каждому ключу отслеживайте в личном кабинете