Ключи API, квота и использование
Группы ключей, лимиты квоты, ограничения моделей и IP, срок действия, журналы и статистика использования.
На этой странице описаны настройки ключей API, правила учёта квоты LLM и способы отслеживания использования с помощью журналов и статистики.
Как работает квота
- Квота аккаунта: при активации LLM API создаётся отдельный аккаунт LLM, с которого списывается стоимость использования моделей. Он управляется отдельно от основного баланса аккаунта. Пополнить его можно переводом или кодом пополнения. В разделе Обзор аккаунта поле Текущий баланс показывает остаток, а История расхода — расходы за всё время.
- Отображение сумм: консоль показывает квоту в долларах США. При вводе числового значения квоты в настройках ключа действует соотношение 500000 quota units = $1.
- Тарификация: большинство моделей отдельно тарифицируют входные и выходные токены. Некоторые модели с отметкой Оплата за запрос тарифицируются за вызов. В разделе LLM API → Модели и цены указаны цены каждой модели на входные и выходные токены за 1K tokens, а также её коэффициенты. Группа также может применять ценовой множитель, который отображается в параметрах группы при создании ключа.
Каждый запрос должен укладываться и в квоту аккаунта, и в собственный лимит квоты ключа. Если исчерпана хотя бы одна из них, запрос завершится ошибкой.
Управление ключами API
Откройте LLM API → API-токены (/llm/tokens). Для каждого ключа в списке отображаются следующие столбцы:
| Столбец | Описание |
|---|---|
| Название | Имя, указанное при создании ключа |
| Состояние | Включено / Отключено / Срок действия истёк / Исчерпано |
| Остаток/общий лимит | Индикатор оставшейся квоты. Для ключей с неограниченной квотой отображается Неограниченный лимит. |
| Группа | Группа ключа. Интеллектуальное отключение при сбоях означает автоматическую группу. |
| Ключ | По умолчанию частично скрыт. Нажмите значок глаза, чтобы показать его, или значок копирования, чтобы скопировать. |
| Доступные модели | Без ограничений |
| Ограничение по IP | Без ограничений |
| Создан / Истекает | Никогда |
В столбце Действия используйте переключатель для включения или отключения ключа, значок редактирования для изменения настроек или значок удаления для удаления ключа. Запросы с удалённым ключом сразу завершаются ошибкой.
Параметры ключа
| Поле | Описание |
|---|---|
| Название | Обязательное поле. Называйте ключи по назначению, например "prod-support-bot". |
| Группа | Оставьте пустым, чтобы использовать группу по умолчанию. В списке отображаются только группы, доступные вашему аккаунту; для каждой могут быть указаны описание и ценовой множитель. Выберите Интеллектуальное отключение при сбоях, чтобы платформа сама выбирала доступную группу. Группа определяет, какие модели может вызывать ключ, и ценовой множитель. |
| Неограниченная квота | Если включено, у ключа нет собственного лимита и он ограничен только квотой аккаунта. |
| Лимит квоты | Отображается, когда неограниченная квота отключена. Введите максимальную квоту, которую может потратить этот ключ (500000 = $1). После её исчерпания статус ключа меняется на «Исчерпан». |
| Включить ограничение моделей / Доступные модели | Если включено, перечислите через запятую имена моделей, которые может вызывать ключ, например gpt-4o-mini,text-embedding-3-small. Запросы к другим моделям отклоняются. |
| Ограничение по IP | По одному разрешённому исходному IP-адресу на строку. Оставьте пустым, если ограничение не требуется. Используйте, если вызовы поступают только с определённых серверов. |
| Срок действия | Оставьте пустым для бессрочного ключа. Нельзя выбрать время в прошлом. По истечении указанного времени статус ключа меняется на «Истёк». |
Если при редактировании отключённого или просроченного ключа задать действительный срок действия или убрать его, ключ автоматически включится при сохранении.
Рекомендации по безопасности
- Создавайте отдельные ключи для каждого приложения и окружения, чтобы их можно было отключать и проверять по отдельности.
- Задавайте лимит квоты для ключей, используемых общедоступными приложениями. Это ограничит потери при утечке ключа.
- По возможности задавайте ограничение по IP для вызовов с серверов.
- Храните ключи только на сервере, никогда не размещайте их в коде браузерных или мобильных приложений. Если вы подозреваете утечку ключа, сразу отключите или удалите его и создайте новый.
Пополнение квоты
- Перевод: в разделе «Обзор аккаунта» нажмите Перевести в карточке «Текущий баланс», чтобы перевести средства с основного баланса. Минимальная сумма — 1; в диалоговом окне показано, сколько квоты вы получите. Перевод нельзя отменить.
- Код пополнения: введите код в карточке Пополнить по коду в разделе «Обзор аккаунта» и нажмите Активировать.
- Пополнение основного баланса: нажмите Пополнить в карточке «Текущий баланс», чтобы перейти в раздел Биллинг → Баланс.
Журналы использования
В разделе LLM API → Журнал запросов (/llm/logs) перечислены все вызовы и изменения квоты.
- Фильтры: период, имя ключа (токена), имя модели и тип. Доступные типы: Пополнить, Расходы, Управление, Система и Ошибка.
- Столбцы: время, ключ, тип, модель, длительность и время до первого токена, входные токены, выходные токены, стоимость, исходный IP-адрес и подробности. Если запрошенная модель была сопоставлена с другой моделью, в записи отображаются и запрошенная модель, и фактическая модель.
- Сводка: вверху страницы показаны итоги для текущего фильтра, например общее количество записей, успешных и неудачных запросов.
При устранении неполадок сначала отфильтруйте записи по типу Ошибка, затем прочитайте сообщение об ошибке в подробностях.
Статистика использования
Раздел LLM API → Использование (/llm/stats) содержит сводку использования за период:
- Общая, использованная и оставшаяся квота, а также доля использованной квоты
- Запросы, токены и расходы за выбранный период
- График динамики использования, расходы по моделям и рейтинг моделей по количеству запросов
- Таблица с разбивкой по дням: дата, модель, запросы, токены и потраченная квота
На странице Обзор аккаунта также отображается краткая сводка: количество запросов, квота и токены за период, а также средние RPM (запросы в минуту) и TPM (токены в минуту) за выбранный диапазон дат.