API429 / LibreChat

Как подключить LibreChat к API429

Добавьте API429 как custom endpoint в существующую установку LibreChat. Для первого текстового запроса используйте gemini-3.8-flash через OpenAI Chat Completions. Ниже приведено дополнение к конфигурации, которое нужно объединить с вашим файлом, сохранив требования установленной версии и остальные работающие подключения.

Настройка сверена с публичной документацией приложения и API429. Полный запуск в LibreChat, импорт в установленный клиент и агентные сценарии здесь не подтверждены. Начните с короткого несекретного запроса и проверьте ответ в своей версии.

Параметры подключения

Протокол
OpenAI Chat Completions
Режим соединения
LibreChat: custom endpoint в YAML
Base URL
https://gateway.api429.com/v1
Точный ID для проверки
gemini-3.8-flash

Доступ конкретного ключа проверяйте через GET /v1/models. Публичная карточка модели не гарантирует её доступность в приложении. Храните ключ в предусмотренном приложением защищённом хранилище или в окружении текущей сессии. Не передавайте значение ключа аргументом команды и не сохраняйте его в общих файлах проекта.

Проверьте конфигурацию установленной версии

Начните с действующего валидного librechat.yaml вашей установки. Справочник LibreChat описывает актуальную ветку документации и не определяет версию уже установленного приложения. Не переносите номер версии из чужого примера вслепую. Сохраните обязательные корневые поля, настройки входа и существующие провайдеры. Образец содержит только дополнение endpoints.custom; это не полный конфигурационный файл для развёртывания нового сервера.

В существующий список custom добавьте объект с уникальным именем API429. Если раздел endpoints уже есть, объедините его содержимое, а не создавайте второй одноимённый ключ YAML. Так вы избежите незаметной замены прежних настроек при чтении файла. После редактирования сначала проверьте синтаксис локально и убедитесь, что формат принимается вашей версией, не отправляя генерацию только ради проверки отступов.

Передайте ключ окружением и подключите файл

Поле apiKey содержит документированную ссылку ${API429_API_KEY}. Значение переменной должно быть доступно серверному процессу LibreChat через защищённую конфигурацию развёртывания. Это подстановка LibreChat, а не секрет в YAML и не предположение о поведении docker --env-file. Не заменяйте ссылку настоящим ключом в репозитории. Проверьте наличие переменной без вывода её значения в консоль или отчёт.

Для Docker официальный quickstart показывает bind mount локального librechat.yaml в /app/librechat.yaml сервиса api. Пример монтирования ниже добавляется к вашему существующему compose override. Для локального запуска без контейнера такое монтирование не требуется. Применяйте изменения штатным способом для вашей установки и учитывайте перезапуск сервиса. Не копируйте весь чужой compose файл поверх своей конфигурации только ради одного подключения.

Выберите правильный маршрут и отключите лишние задачи

Укажите baseURL https://gateway.api429.com/v1: стандартный custom клиент добавляет chat/completions. Полный путь запроса должен получиться https://gateway.api429.com/v1/chat/completions. Параметр directEndpoint изменяет трактовку адреса, поэтому в этом дополнении его нет. Не добавляйте provider: anthropic: это отдельный нативный режим Anthropic Messages, а здесь выбран обычный OpenAI-совместимый текстовый запрос.

В models.default оставьте точный ID gemini-3.8-flash; fetch:false выключает автоматическое получение списка для этого endpoint. titleConvo:false отключает генерацию названия беседы. Эти настройки не удостоверяют доступ ключа и не исключают все дополнительные функции приложения. В addParams заданы max_tokens:256 и stream:false для начального текста; не добавляйте инструменты, вложения и неподтверждённые поля только потому, что конфигурация позволяет их описать.

Проверьте первый ответ без повторов вслепую

После применения конфигурации откройте новый обычный чат, выберите endpoint API429 и указанную модель. Если пункт не появился, проверьте структуру файла, обязательные поля установленной версии и доступность монтирования. Не меняйте одновременно адрес, модель и секрет: последовательная диагностика помогает понять причину ошибки. Наличие пункта в списке ещё не доказывает, что ссылка на переменную окружения успешно разрешилась.

Отправьте одно короткое несекретное сообщение и проверьте текст ответа, выбранный ID и расход в кабинете API429. Генерация платная; перед повтором убедитесь, что первый запрос завершился. При ошибке доступа отдельно сверяйте авторизованный GET /v1/models, а не только публичную карточку. Параметр max_tokens ограничивает ответ, но не устанавливает общий бюджет: входные сообщения, длинная история и дополнительные обращения увеличивают общую стоимость.

Общий ключ и границы сценария

Серверная переменная в этом варианте задаёт общий ключ развёртывания. Ограничьте круг пользователей и права на endpoint средствами вашей установки. Официальная документация отдельно описывает user_provided для личных ключей; это другая организация доступа, которую нужно настроить осознанно. Проверка текстового ответа не подтверждает агентные задачи, вызовы инструментов, строгие схемы, медиа или весь набор возможностей интерфейса. Цены и единицы оплаты смотрите в существующих карточках и сравнении тарифов, не в списке моделей LibreChat.

Настройки и примеры

Дополнение endpoints.custom к существующему валидному librechat.yaml

endpoints:
  custom:
    - name: 'API429'
      apiKey: '${API429_API_KEY}'
      baseURL: 'https://gateway.api429.com/v1'
      models:
        default: ['gemini-3.8-flash']
        fetch: false
      titleConvo: false
      addParams:
        max_tokens: 256
        stream: false

Docker: дополнение bind mount к существующему override

services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml

Расход и следующие шаги

Гипотетический объём за час: 30 запросов к gemini-3.8-flash, каждый с 5 000 обычных входных и 512 выходными токенами, — около $0.05 по текущим ставкам API429. Кеш, инструменты, повторы, подписка приложения и другие сборы не включены. Дата каталога: .

Фактический расход зависит от числа запросов, длины контекста и ответов — смотрите его в личном кабинете API429.

Общий протокол OpenAI Compatible · Документация API429 · Помощь и диагностика

Оплата и тест $10

  • Карта российского банка. Пополнение баланса в личном кабинете.
  • Счёт для юрлиц. Безналичная оплата с закрывающими документами.
  • USDT и TON. Пополнение криптовалютой.

Тест $10. Подпишитесь на наш Telegram-канал через бота — получите $10 на баланс для первых запросов. Получить $10 в боте

Частые вопросы

Можно заменить librechat.yaml только этим примером?

Нет. Это дополнение endpoints.custom к существующему валидному файлу установленной версии. Сохраните корневые обязательные поля и объедините существующие разделы. Для Docker отдельно проверьте bind mount в /app/librechat.yaml.

Зачем одновременно fetch:false и models.default?

Ручной список задаёт первоначальный точный ID без автоматического запроса списка этим endpoint. Это удобно для контролируемой настройки, но не заменяет отдельную проверку доступа вашего ключа через GET /v1/models.

Нужен ли directEndpoint для API429?

В этой настройке нет: baseURL заканчивается /v1, а клиент добавляет chat/completions. directEndpoint:true предназначен для другой трактовки полного адреса. Его включение без изменения адреса нарушит выбранный контракт.

Является ли ключ из окружения личным для каждого пользователя?

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

Источники

Справочник приложения определяет его интерфейс и ограничения; документация API429 — адреса, авторизацию и клиентские методы. Дата сверки: .

Telegram