Аутентификация
Все запросы требуют API-ключ Claudexia.
Формат API-ключа
sk_cdx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxПоддерживаемые заголовки аутентификации
Запросы в стиле Anthropic
Используйте x-api-key:
bash
curl https://api.claudexia.tech/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.claudexia.tech/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 для обычного ответа |
Советы по безопасности
- Держите отдельные ключи для личного использования, приложений и автоматизации
- Удаляйте ключи, которыми больше не пользуетесь
- Выберите Cheap без резерва, если не хотите разрешать запросы через Premium
- Задавайте срок действия для временных интеграций
- Следите за расходом по каждому ключу в личном кабинете