Аккаунт

API-ключи

Создавайте ключи, ограничивайте, сколько каждый может потратить и что вызывать, меняйте и отзывайте их без простоя.

API-ключи аутентифицируют ваши запросы и списывают средства с баланса учётной записи. Ключей можно создать сколько угодно и задать каждому свои лимиты. Все ключи используют один и тот же баланс.

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

Откройте API-ключи
Перейдите в раздел API-ключи в панели и нажмите Новый ключ.
Назовите ключ и выберите группу каналов
Назовите ключ по месту, где он будет работать, например checkout-prod или eval-runner. Оставьте в поле Группа каналов значение Авто — лучший из доступных, если только вам не нужно, чтобы каждый запрос с этого ключа шёл через одну определённую группу. См. Группы каналов.
Задайте лимиты (необязательно)
Откройте Лимиты и ограничения, чтобы ограничить расходы, частоту запросов, параллелизм, модели или срок действия. Каждый параметр описан ниже, и все их можно изменить позже.
Скопируйте ключ
Нажмите Создать. Полный ключ показывается один раз, в баннере вверху страницы. Скопируйте его или нажмите Использовать в инструментах…, чтобы настроить с ним Claude Code, Codex CLI и другие клиенты. После нажатия Готово видны только первые символы ключа, например lr-a1b2c3….

Ключ показывается один раз

Lovely Router хранит только хеш каждого ключа. Если вы потеряли ключ, отзовите его и создайте новый.

Параметры ключа#

Параметр	По умолчанию	Что делает
Имя	—	Метка в списке ключей и в Логах. До 60 символов.
Группа каналов	Авто	Направляет все запросы с этого ключа в одну группу каналов. Авто выбирает лучшую доступную группу для каждого запроса. Задаётся только при создании.
Лимит расходов (USD)	Без лимита	Максимум, который ключ может потратить за всё время, в целых долларах: на запросы к моделям, запуски инструментов и браузерного агента. Это пожизненный потолок, а не месячный бюджет.
Истекает	Никогда	Ключ перестаёт работать по окончании этого дня в часовом поясе вашего браузера.
Запросов в минуту	Без ограничений	Сколько запросов к моделям ключ может начать за минуту.
Макс. число параллельных запросов	Без ограничений	Сколько запросов к моделям ключ может выполнять одновременно. Длинный поток учитывается до своего завершения.
Разрешить только выбранные модели	Все модели	Список моделей, которые ключу разрешено вызывать. Алиасы вроде `claude-sonnet-5-5` считаются той моделью, на которую указывают.

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

Что происходит при достижении лимита#

Отклонённый запрос не оплачивается и не появляется в Логах. Тело ответа имеет формат того API, который вы вызвали.

Ситуация	Статус	Тип Anthropic	Тип OpenAI	Сообщение
Срок действия ключа истёк	`401`	`authentication_error`	`authentication_error`	`This API key has expired`
Ключ отозван	`401`	`authentication_error`	`authentication_error`	`Invalid or revoked API key`
Модели нет в списке разрешённых	`403`	`permission_error`	`permission_denied`	`This API key is not allowed to use 'gpt-6.1-sol'.`
Достигнут лимит расходов	`402`	`billing_error`	`insufficient_quota`	`This API key has reached its spend limit.`
Достигнут лимит запросов в минуту или параллелизма	`429`	`rate_limit_error`	`rate_limit_exceeded`	`This API key has reached its rate or concurrency limit.`

Запросы в формате Gemini получают те же коды статуса в формате ошибок Gemini. Ответ 429 из-за лимита ключа содержит заголовок Retry-After с числом секунд ожидания. Ниже ошибка лимита расходов в обоих форматах. Все остальные тела ошибок и советы по повторным попыткам — в разделе Ошибки.

JSON

{
  "type": "error",
  "error": {
    "type": "billing_error",
    "message": "This API key has reached its spend limit."
  }
}

Какие лимиты действуют на инструменты и запуски браузера#

Лимит	Запросы к моделям	Инструменты данных и браузерный агент
Срок действия и отзыв	Да	Да
Лимит расходов	Да	Да
Запросов в минуту	Да	Нет
Макс. число параллельных запросов	Да	Нет
Список разрешённых моделей	Да	Нет

Лимит расходов проверяется перед началом каждого запроса. Уже выполняющийся запрос к модели всегда доводится до конца, поэтому итоговая сумма по ключу может немного превысить лимит. Запуск инструмента или браузера заранее резервирует свою максимальную стоимость, поэтому он отклоняется с 402, если этот максимум выведет ключ за его лимит.

Изменение ключа#

Нажмите Изменить у ключа, чтобы поменять имя, лимит расходов, дату истечения, лимиты частоты и параллелизма или список разрешённых моделей. Изменения действуют со следующего запроса. Очистка поля снимает соответствующий лимит.

Чтобы перенести ключ в другую группу каналов, создайте новый ключ в этой группе и перейдите на него.

Отзыв ключа#

Нажмите Отозвать, затем Подтвердить отзыв. Ключ перестаёт работать со следующего запроса, и отменить отзыв нельзя. Отозванный ключ остаётся в списке серым вместе с историей расходов, а его запросы остаются в Логах.

Ротация ключа#

Замените ключ без простоя:

Создайте новый ключ с той же группой и теми же лимитами.
Разверните новый ключ в приложении или менеджере секретов.
Дождитесь, пока время Последнее использование у старого ключа перестанет меняться.
Отзовите старый ключ.

Меняйте ключи по расписанию, после ухода человека, у которого был доступ, и немедленно, если ключ мог утечь.

Ключ в ваших инструментах#

Нажмите Использовать в инструментах у любого ключа, чтобы получить готовые настройки для Claude Code, Codex CLI, Gemini CLI, Cherry Studio, DeepChat и AionUI с импортом в один клик там, где приложение это поддерживает. См. Работа с вашими инструментами.

API-ключи

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

Откройте API-ключи

Назовите ключ и выберите группу каналов

Задайте лимиты (необязательно)

Скопируйте ключ