Каналы Premium и Cheap
В codexkey два канала доступа к моделям. От канала зависит, какие модели видны ключу и сколько стоит токен.
Два канала
- Premium: все модели, прямой доступ. Стоит по умолчанию у всех ключей.
- Cheap: дешевле, одна цена на любой токен, но только те модели, что есть в Cheap.
Список моделей Cheap виден в каталоге.
Режимы маршрутизации ключа
Каналы ключа определяет режим маршрутизации: один канал либо оба с переключением.
| Режим | Что делает |
|---|---|
premium | Только Premium. Режим по умолчанию. |
cheap | Только Cheap. |
auto_premium | Сначала Premium; после 4 неудачных попыток подряд запрос переходит в Cheap. |
auto_cheap | Сначала Cheap; после 4 неудачных попыток подряд запрос переходит в Premium. |
max | Максимальная ёмкость: каждый запрос направляется в наименее загруженный канал. |
Оплата идёт по тарифу того канала, который ответил. Запрос, ушедший в Premium, оплачивается по цене Premium.
Если модели нет ни в одном канале ключа, запрос завершается ошибкой 403 model_not_in_channel, и деньги не списываются.
Как выбрать режим
- Откройте раздел «API-ключи» в кабинете.
- Канал выбирается при создании ключа или меняется через «Редактировать».
- Изменение вступает в силу в течение нескольких секунд.
Режимы auto_premium, auto_cheap и max доступны, когда для аккаунта включено переключение между каналами. Если режима нет в списке, для вас он закрыт: обратитесь в поддержку.
Ключ «Чат на сайте»
Чат на сайте работает через служебный ключ «Чат на сайте». Режим у него Cheap, а при сбоях запрос уходит в Premium (auto_cheap). Удалить или перевыпустить такой ключ нельзя.
Цены по каналам
- В Premium входные и выходные токены имеют разные цены. В Cheap цена одна на любой токен.
- Цены каждой модели в обоих каналах указаны в каталоге: на странице модели есть переключатель Premium / Cheap.
- От канала зависят и картинки с видео; подробности в разделе Картинки и видео.
Ошибки каналов
| HTTP | code | Когда |
|---|---|---|
403 | model_not_in_channel | Модели нет в канале ключа. Смените канал ключа или модель. |
403 | channel_not_allowed | Канал Cheap закрыт для вашего аккаунта. |
403 | fallback_not_allowed | Для аккаунта не включено переключение между каналами. Касается режимов auto_premium, auto_cheap и max. |
422 | channel_unavailable | В канале пока нет моделей. |
422 | invalid_state | Ключ отозван. |
Остальные ошибки API перечислены в справочнике ошибок.