Перейти к содержимому

Настройка API-ключей

API-ключи Claudexia поддерживают гибкую настройку лимитов запросов, ограничений по моделям, IP-фильтрацию и бюджеты. В этом руководстве описано создание, настройка, ротация и удаление ключей.

Создание ключей

  1. Откройте Панель управления > API-ключи.
  2. Нажмите «Создать ключ» и введите название.
  3. Скопируйте ключ сразу — он отображается только один раз.
  4. После создания настройте лимиты, модели и безопасность.

Формат ключа

Все ключи Claudexia имеют следующий формат:

sk_cdx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Префикс sk_cdx_ идентифицирует ключ как ключ Claudexia.

Настройки для каждого ключа

Каждый ключ настраивается независимо через панель управления.

Лимиты запросов

  • Запросы в минуту (RPM) — ограничивает количество запросов в минуту.
  • Максимум токенов на запрос — ограничивает выходные токены в одном запросе.
  • Дневной / недельный / месячный бюджет — отключает ключ при достижении порога расходов.

Ограничения по моделям

Ограничьте ключ определёнными ID моделей. Запрос модели вне списка вернёт ошибку 403.

IP-фильтрация

Ограничьте запросы определёнными IP-адресами. Реальный IP клиента определяется из заголовков прокси (CF-Connecting-IP, X-Forwarded-For).

Ограничения по IDE

Ограничьте ключ определёнными user-agent клиентами, такими как Cursor, Claude Code или расширения VS Code.

Ротация ключей

Чтобы сменить ключ без простоя:

  1. Создайте новый ключ с той же конфигурацией.
  2. Обновите приложение для использования нового ключа.
  3. Убедитесь, что новый ключ работает.
  4. Удалите или заморозьте старый ключ.

Оба ключа будут работать одновременно во время перехода.

Удаление ключей

Удалённые ключи перестают работать немедленно и не могут быть восстановлены.

Удаление необратимо. Если нужно временно отключить ключ, используйте функцию заморозки.