Использовать в своих инструментах
Подключите Claude Code, Codex CLI, Gemini CLI, десктопные чат-приложения и официальные SDK к Lovely Router одним API-ключом.
С Lovely Router работает любой инструмент, в котором можно изменить базовый URL API. Вы меняете две настройки, базовый URL и ключ, а всё остальное оставляете как есть. Сначала вам понадобится API-ключ.
Настройка в один клик#
На странице API-ключи у каждого ключа есть кнопка Использовать в инструментах, а рядом с только что созданным ключом — кнопка Использовать в инструментах…. Она открывает диалог с настройками для каждого клиента ниже, уже заполненными вашим ключом, и ссылками для импорта в один клик:
- Claude Code, Codex CLI, Gemini CLI: Импорт через CC Switch добавляет Lovely Router как провайдера в десктопное приложение CC Switch с уже настроенными моделями. CC Switch должен быть установлен.
- Cherry Studio, DeepChat, AionUI: Открыть в приложении добавляет Lovely Router как провайдера. Приложение должно быть установлено.
Сразу после создания ключа диалог уже содержит его. Для существующего ключа вставьте ключ в диалог целиком: Lovely Router хранит только его хеш, поэтому показать ключ повторно не может.
Настройка клиента#
В каждом руководстве — полная настройка одного клиента: команды и конфигурационные файлы, какие модели выбрать и как исправить типичные ошибки.
Anthropic Messages API. Две переменные окружения или settings.json, с кешированием промптов.
OpenAI Responses API с моделями GPT. Один провайдер моделей в config.toml.
Gemini API. Две переменные окружения.
Десктопное чат-приложение. OpenAI-совместимый провайдер, импорт в один клик.
Десктопное чат-приложение. OpenAI-совместимый провайдер, импорт в один клик.
Десктопное приложение для моделей и агентов. OpenAI-совместимый провайдер, импорт в один клик.
Любое приложение, агентный фреймворк или библиотека с пользовательским эндпоинтом OpenAI.
Официальные SDK OpenAI, Anthropic и Google Gen AI для Python и Node.js.
Базовый URL по формату API#
Базовый URL зависит от API, на котором говорит клиент, а не от модели:
| Формат API | Клиенты | Базовый URL |
|---|---|---|
| Anthropic Messages | Claude Code, Anthropic SDK | https://lovelyrouter.com |
| OpenAI Chat Completions и Responses | Codex CLI, OpenAI SDK, OpenAI-совместимые приложения | https://lovelyrouter.com/v1 |
| Gemini | Gemini CLI, Google Gen AI SDK | https://lovelyrouter.com |
| OpenAI-совместимый «API host» | Cherry Studio, DeepChat, AionUI | https://lovelyrouter.com (приложение само добавляет /v1) |
Инструменты данных для агента через MCP#
MCP-сервер по адресу https://lovelyrouter.com/mcp даёт любому MCP-клиенту инструменты данных и браузерного агента с оплатой с того же баланса. Он авторизуется тем же ключом. В руководствах по Claude Code, Codex CLI и Gemini CLI есть команда в одну строку. Другие клиенты и полный список MCP-инструментов описаны в разделе MCP-сервер.
Устранение неполадок#
| Симптом | Решение |
|---|---|
401 с Missing API key | Инструмент не отправляет ключ. Проверьте имя переменной и то, что вы экспортировали её в той оболочке, из которой запускается инструмент. |
401 с Invalid or revoked API key | Ключ введён с ошибкой, обрезан или отозван. Вставьте его снова или создайте новый. |
404 с Model '...' is not available | Такого id модели не существует. Скопируйте id из GET /v1/models или из списка моделей. |
404 с Unknown endpoint | Инструмент вызывает API, которое Lovely Router не обслуживает, например эмбеддинги или аудио. Переключите его на Chat Completions, Responses API или формат Anthropic либо Gemini. |
404 на пути, содержащем /v1/v1/ | Приложение само добавляет /v1. Укажите https://lovelyrouter.com в качестве хоста. |
402 | Баланс исчерпан или ключ достиг лимита расходов. См. Кредит и оплата. |
Ошибки, характерные для конкретного клиента, перечислены в его руководстве. Все остальные статусы описаны в разделе Ошибки.