Перейти к основному содержанию
LibreChat — self-hosted веб-интерфейс в духе ChatGPT с поддержкой множества провайдеров. RuAPI добавляется как custom endpoint в 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 и сам включает кэш промптов (подробнее — Кэширование промптов):
Модели Claude здесь перечисляются вручную: автозагрузка списка для provider: "anthropic" не используется. Рассуждение (Thinking) в этом эндпоинте включено по умолчанию, его токены оплачиваются как output.

Проверка

В интерфейсе выберите провайдер RuAPI и модель, отправьте сообщение. Ответ + запись в Консоли RuAPI → Журнал запросов означают, что связка работает.

Решение проблем

  • Проверьте, что librechat.yaml смонтирован в контейнер через docker-compose.override.yml (шаг «Подключите librechat.yaml к контейнеру»).
  • Проверьте отступы в librechat.yaml (YAML чувствителен к ним) и что блок лежит под endpoints.custom. Ошибки разбора видны в docker compose logs api.
  • Убедитесь, что контейнер перезапущен после правок.
  • 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 указывает на доступную модель.