Настройка сверена с публичной документацией приложения и 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: falseDocker: дополнение 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.
- Gemini 3.8 Flash: точный ID и текущая цена API429
- Google / Gemini через API429
- Сравнение тарифов Gemini и единицы оплаты
- Документация: авторизация и методы 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 — адреса, авторизацию и клиентские методы. Дата сверки: .