librechat.yaml — после этого выбранные модели RuAPI появляются в выпадающем списке.
Предварительные требования
1
Аккаунт RuAPI и API-ключ
Консоль → API-ключи → создайте ключ
sk-.... Этим ключом будут пользоваться все аккаунты вашего LibreChat, поэтому задайте ему бюджет: выключите «Без ограничений» и впишите сумму. Баланс пополняется в USDT — см. Пополнение.2
LibreChat
Установка по инструкции LibreChat (обычно Docker):
git clone https://github.com/LibreChat-AI/LibreChat.git, cd LibreChat, cp .env.example .env.Настройка
1
Добавьте ключ в .env
2
Подключите librechat.yaml к контейнеру (Docker)
Сам по себе контейнер
librechat.yaml не читает — файл нужно смонтировать. Скопируйте пример: cp docker-compose.override.yml.example docker-compose.override.yml — и раскомментируйте в нём строку services: и блок с конфигом:3
Добавьте RuAPI в librechat.yaml
Создайте
librechat.yaml рядом с .env:4
Перезапустите LibreChat
docker compose down && docker compose up -d. Откройте http://localhost:3080 — в меню выбора модели появится провайдер RuAPI с моделями из default.fetch: true вместо ручного списка подтянет весь каталог RuAPI через /v1/models — вместе с моделями для картинок и видео, поэтому удобнее перечислить нужные ID в default. На каждый новый чат LibreChat делает отдельный запрос за заголовком; если titleModel не задан, он берёт модель самого чата, поэтому заголовки лучше отдать deepseek-flash.Claude с кэшем промптов: отдельный эндпоинт Anthropic
Через OpenAI-совместимый custom endpoint Claude работает, но LibreChat не ставит в таких запросах меткиcache_control, и работает только автокэш RuAPI: на первом ходу нового диалога кэшируется в лучшем случае только системный промпт, а после перерыва больше 5 минут кэш истекает и вся история чата оплачивается заново. Добавьте в custom второй элемент с provider: "anthropic" — тогда LibreChat говорит с Claude в нативном формате Anthropic и сам включает кэш промптов (подробнее — Кэширование промптов):
provider: "anthropic" не используется. Рассуждение (Thinking) в этом эндпоинте включено по умолчанию, его токены оплачиваются как output.
Проверка
В интерфейсе выберите провайдер RuAPI и модель, отправьте сообщение. Ответ + запись в Консоли RuAPI → Журнал запросов означают, что связка работает.Решение проблем
Провайдер RuAPI не появился
Провайдер RuAPI не появился
- Проверьте, что
librechat.yamlсмонтирован в контейнер черезdocker-compose.override.yml(шаг «Подключите librechat.yaml к контейнеру»). - Проверьте отступы в
librechat.yaml(YAML чувствителен к ним) и что блок лежит подendpoints.custom. Ошибки разбора видны вdocker compose logs api. - Убедитесь, что контейнер перезапущен после правок.
Ошибка 401 или 404
Ошибка 401 или 404
- 401: переменная
RUAPI_KEYв.envдолжна содержать ключ RuAPI целиком (sk-...), аapiKey— ссылаться на неё через${RUAPI_KEY}. - 404: у OpenAI-совместимого эндпоинта
baseURL—https://www.ruapi.ai/v1с/v1, у эндпоинта сprovider: "anthropic"—https://www.ruapi.aiбез/v1.
Модель отвечает ошибкой
Модель отвечает ошибкой
До первого пополнения работают только
claude-haiku-5-5, deepseek-flash и gpt-6-luna. Коды ошибок — Ошибки.Заголовки чатов не генерируются
Заголовки чатов не генерируются
Проверьте
titleConvo: true и что titleModel указывает на доступную модель.