API429 / LobeChat / LobeHub

Как подключить LobeChat / LobeHub к API429

Настройте серверное OpenAI-совместимое подключение LobeChat / LobeHub к API429 и оставьте одну текстовую модель gemini-3.8-flash. Текущие официальные исходники справочника используют название LobeHub; перед применением сопоставьте их с вашей версией приложения и не считайте документацию canary гарантией поведения установленного релиза.

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

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

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

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

Определите версию и место настройки

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

Проверенные ссылки ведут на ветку canary официального репозитория LobeHub. Это изменяемая ветка разработки; её содержимое может отличаться от конкретного release tag. Для установленного тега проверьте соответствующие имена параметров по его документации. Показанная схема — проверенный по источникам кандидат настройки, а не отчёт об исполнении запросов в каждой версии LobeChat или LobeHub.

Задайте серверный провайдер OpenAI

В окружении серверного процесса включите ENABLED_OPENAI=1. Поле OPENAI_PROXY_URL должно содержать https://gateway.api429.com/v1, без полного суффикса chat/completions. OPENAI_API_KEY получает ключ API429 через защищённую конфигурацию запуска. Название переменной связано с адаптером приложения: оно не требует приобретать другой ключ и не меняет выбранный протокол запроса. Ожидаемый конечный путь — /v1/chat/completions.

В листе параметров ниже YOUR_API429_KEY — буквальная заглушка. Передайте настоящий секрет штатным механизмом вашей установки, не аргументом команды и не в общем файле проекта. Переменные должны попасть именно в процесс приложения; наличие локальной переменной в отдельной оболочке само по себе этого не доказывает. Образец не является shell-скриптом и не обещает подстановку переменных при использовании docker --env-file.

Скройте встроенный список и добавьте точный ID

Значение OPENAI_MODEL_LIST=-all,+gemini-3.8-flash сначала скрывает встроенные варианты, затем добавляет выбранную модель. Разделитель элементов — обычная запятая. На первом этапе оставьте идентификатор без переименования и дополнительных расширений: так проще сопоставить выбор в интерфейсе, запись каталога и отправленный параметр model. Оформление списка не создаёт права доступа и не устанавливает цену.

Не добавляйте флаги fc, vision или imageOutput. Справочник описывает эти обозначения как расширения списка, но объявление флага не создаёт возможности у сервиса. Начальная задача ограничена обычным текстом, без поиска, файлов, инструментов и агентных циклов. Даже если интерфейс показывает дополнительную кнопку, совместимость конкретного запроса надо проверять отдельно по клиентскому контракту и выбранной модели.

Сопоставьте каталог, первый запрос и расход

После применения окружения штатным способом откройте новый обычный диалог и выберите gemini-3.8-flash. Если виден старый список, проверьте действующую конфигурацию установленной версии и сохранённые пользовательские настройки до отправки сообщения. Сравните точный ID с публичным каталогом API429; затем отдельно подтвердите доступ ключа авторизованным GET /v1/models. Секрет не должен попадать в отчёт о результатах проверки.

Для первого сообщения задайте ограничение ответа max_tokens:256 и отключите потоковую выдачу там, где это позволяет ваша версия. Контрольный JSON ниже показывает целевой обычный контракт, а не дополнительную переменную окружения LobeHub. Отправьте короткий несекретный текст и проверьте ответ. Если приложение не позволяет выставить требуемое поле, выясните его поведение по документации версии, не считайте визуально выбранный лимит доказательством отправленного тела.

Учитывайте общий ключ и неизвестные дополнительные вызовы

Генерация платная. Общий серверный ключ оплачивает работу допущенных пользователей, поэтому права и наблюдение за расходом организует администратор приложения. Токенный предел отдельного ответа не устанавливает общий бюджет: история сообщений, количество обращений и дополнительные задачи влияют на общую стоимость. Для этой конфигурации не подтверждено точное число фоновых запросов или повторов клиента; одна кнопка отправки не служит гарантией одного обращения. При ошибке сначала проверьте адрес, ключ и ID, а затем принимайте решение о повторе.

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

Параметры серверного окружения; заглушка ключа

ENABLED_OPENAI=1
OPENAI_API_KEY=YOUR_API429_KEY
OPENAI_PROXY_URL=https://gateway.api429.com/v1
OPENAI_MODEL_LIST=-all,+gemini-3.8-flash

Контрольный текстовый контракт API429; не импорт LobeHub

{
  "model": "gemini-3.8-flash",
  "messages": [
    {
      "role": "user",
      "content": "Ответь одним предложением: что такое API?"
    }
  ],
  "max_tokens": 256,
  "stream": false
}

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

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

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

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

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

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

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

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

Почему инструкция называется LobeChat / LobeHub?

Официальный текущий справочник использует LobeHub, а многие установки известны под названием LobeChat. Проверяйте конкретную версию и её руководство; совпадение названия продукта не означает идентичность всех параметров релизов.

Документация canary подходит любому релизу?

Нет. Canary изменяется отдельно от установленного тега. Перед редактированием окружения сопоставьте параметры и способ применения со своим release tag. Здесь проверены источники, а не запуск всех выпусков клиента.

Зачем -all перед выбранной моделью?

Так синтаксис списка сначала скрывает встроенные варианты и затем показывает явно добавленный ID. Это уменьшает вероятность выбрать неподходящий пункт, но не выдаёт ключу доступ и не проверяет доступность модели.

Можно добавить fc или vision для расширения возможностей?

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

Источники

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

Telegram