Ключ API, выдача и настройки

Кто может получить ключ

Ключ создаётся в кабинете разработчика на странице /developers и принадлежит аккаунту epicai. Для работы ключа нужна подтверждённая почта. Создать ключ может тот, кто хотя бы раз покупал пакет токенов, либо тот, кому доступ открыла администрация. Бонусные токены (за регистрацию, ежедневные, за приглашения) покупкой не считаются. Администрация вправе и закрыть доступ, тогда новые ключи не создаются.

У одного аккаунта может быть до 20 действующих ключей. Для разных проектов удобно заводить разные ключи, расход и лимиты считаются по каждому отдельно. Если аккаунт состоит в организации, администратор может выпустить на его имя ещё и ключи организации, о них рассказывает статья Ключи организации.

Как выглядит ключ

Ключ начинается с sk-epic- и содержит ещё 43 знака из латинских букв и цифр. Всего получается 51 знак. Показывается он один раз, сразу после создания. В базе epicai хранит только SHA-256 от ключа и первые 14 знаков для узнавания в списке, поэтому потерянный ключ восстановить нельзя. Создайте новый, а старый отзовите. О том, как хранить ключ, чтобы он не утёк, говорит статья Как хранить ключ.

Как передать ключ в запросе

Ключ идёт в заголовке Authorization со словом Bearer. Библиотеки OpenAI делают это сами, когда вы задаёте api_key.

Authorization: Bearer sk-epic-ВАШ_КЛЮЧ

Если клиент умеет передавать ключ только в заголовке x-api-key, как это принято у Anthropic, epicai примет и его. Сам протокол при этом остаётся прежним (Chat Completions). Когда пришли оба заголовка, берётся Authorization. Ключ в адресе запроса не принимается.

Запрос без ключа или с неверным ключом получает 401 invalid_api_key. После 20 неверных ключей с одного адреса за 15 минут адрес блокируется на время ожидания (429 too_many_failed_attempts), даже если следующий ключ верный.

Настройки ключа

Настройки задают при создании и меняют позже, сам ключ остаётся прежним. Нулевое или пустое значение означает, что ограничения нет.

Настройка	Что делает
Название	Подпись в списке ключей и в статистике, до 60 знаков
Запросов в минуту	Свой предел для этого ключа. Без него действует значение по умолчанию (60), с ним не больше потолка, который задаёт epicai (по умолчанию 600). Подробности в статье Лимиты
Потолок в день и в месяц	Сколько TOK ключ может потратить за сутки и за календарный месяц по Москве. Суточный потолок не может превышать месячный
Разрешённые модели	Список имён через запятую. Ключ видит только эти модели в списке и может обращаться только к ним. Пустое поле открывает все
Разрешённые адреса	До 10 IP-адресов и подсетей в записи CIDR, IPv4 и IPv6. Запрос с другого адреса получает 403 ip_not_allowed
Срок действия	Дата, после которой ключ перестаёт работать. Задать можно только дату в будущем

Отзыв и блокировка

Отозванный ключ перестаёт работать сразу, на следующем же запросе (401 api_key_revoked). Запись о нём остаётся: в статистике сохраняются расход и история обращений. Ключ с истёкшим сроком отвечает 401 api_key_expired. Если администрация закрыла ключ, ответом будет 403 api_key_blocked, и разблокировать его может только она. Ключ перестаёт работать и тогда, когда блокируется сам аккаунт (403 account_suspended).

Время последнего использования ключ получает не чаще раза в минуту, поэтому в списке оно может отставать от последнего запроса на минуту.