Настройка API-ключей
Ключи создаются и правятся в разделе Панель управления > API-ключи. У ключа есть название, канал, разрешение на резервный Premium и необязательный срок действия. По умолчанию стоит Premium; Cheap выбирают явно, с резервным Premium или без него.
Создание ключей
- Откройте Панель управления > API-ключи.
- Нажмите «Создать ключ», впишите название и укажите режим: Premium, Cheap или Cheap + резервный Premium.
- Если нужно, задайте дату окончания в будущем, затем скопируйте готовый ключ в клиент.
- Название, канал, резервный Premium и срок действия меняются через «Редактировать». Вкладка каталога на ключ не влияет.
Формат ключа
Все ключи codexkey выглядят так:
sk_cdx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxПрефикс sk_cdx_ показывает, что это ключ codexkey.
Настройки для каждого ключа
API ключей личного кабинета принимает поля name, channel, fallback_premium и expires_at. Лимиты запросов, бюджеты, списки моделей, IP-фильтры и ограничения IDE для ключа через него не настраиваются.
Режимы каналов
- Premium: channel=premium, fallback_premium=false. Без channel при создании ключа выбирается Premium.
- Cheap: channel=cheap, fallback_premium=false. Резервный Premium такой ключ не допускает.
- Cheap + резервный Premium: channel=cheap, fallback_premium=true. Когда включать резерв, решает провайдер; запрос через Premium может обойтись дороже.
Про режимы auto_premium, auto_cheap и max, цены по каналам и ошибки каналов читайте на странице Каналы Premium и Cheap.
Доступность моделей
Прежде чем выбрать ID, посмотрите каталог для канала своего ключа. Если доступ к каналу или модели закрыт, вернётся ошибка; расписание повторных попыток и дополнительную пропускную способность мы не обещаем.
Срок действия
В expires_at нужна дата в будущем. Для ключа без срока при создании оставьте поле пустым. Убрать уже заданный срок через текущий API редактирования нельзя.
Настройка клиента
Ключ передаётся в поддерживаемых заголовках Anthropic или OpenAI. Канал и резервный Premium задаются в самом ключе, а не в теле запроса к модели.
Ротация ключей
Чтобы сменить ключ без простоя:
- Создайте новый ключ с той же конфигурацией.
- Переведите приложение на новый ключ.
- Убедитесь, что новый ключ работает.
- Удалите старый ключ после проверки нового.
Пока идёт переход, оба ключа действуют одновременно.
Удаление ключей
Удалённый ключ перестаёт работать сразу, восстановить его нельзя.
Удаление необратимо. Прежде чем убрать старый ключ, убедитесь, что клиенты уже работают с новым.