Запустите приложения FastGPT на кастомном OpenAI-совместимом base URL.
Updated 2026-07-29
Актуальный FastGPT настраивает модели через UI: добавьте канал в Account, Model Providers с протоколом OpenAI, https://api.apisrouter.com/v1 в качестве proxy-адреса и один ключ. Id Claude, GPT, DeepSeek, GLM, Kimi и Qwen затем питают ваши базы знаний и workflow.
Короткий ответ: один канал на странице Model Providers.
Начиная с v4.8.23 FastGPT поставляется с собственным слоем агрегации моделей (AI Proxy) и UI для настройки моделей, так что кастомный эндпоинт больше не требует отдельного деплоя OneAPI или ручной правки config.json. Откройте Account, затем Model Providers, переключитесь на вкладку Model Channels и нажмите Add Channel. Установите тип протокола в OpenAI, назовите канал, укажите https://api.apisrouter.com/v1 в поле proxy-адреса (это base URL, а не полный путь запроса), вставьте свой ключ и выберите или впишите id моделей, которые должен обслуживать канал. Вернувшись на вкладку моделей, включите добавленные id и запустите встроенный тест связности. С этого момента любое приложение FastGPT, база знаний и узел workflow могут выбрать эти модели. Документация двуязычная, и формулировки меняются между релизами (doc.fastgpt.io — англоязычная точка входа), так что относитесь к самому потоку — канал, протокол, base URL, ключ, модели — как к стабильной части, а не к точным формулировкам.
Channel Name: APIsRouter
Protocol Type: OpenAI
Proxy URL: https://api.apisrouter.com/v1
API Key: sk-YOUR-APISROUTER-KEY
Models: claude-sonnet-4-6, deepseek-v4-flash,
glm-5.2, qwen3.7-plus, kimi-k2.6
then: enable the models + run the connection testКак FastGPT маршрутизирует трафик моделей.
FastGPT (labring на GitHub, около 29K звёзд) — платформа баз знаний и workflow китайского происхождения: датасеты с извлечением QA и векторным поиском, визуальная оркестрация Flow, опубликованные приложения с шарингом и доступом по API. Всё это резолвится в модели, зарегистрированные в слое конфигурации. Канал — это правило маршрутизации: эти id моделей, этот base URL, этот ключ. Запросы уходят из FastGPT как стандартные chat completions с id модели в качестве простой строки, поэтому мультивендорный шлюз встаёт как один канал. Слой каналов также несёт операционные фичи, которые иначе пришлось бы строить самим: одна модель может жить в нескольких каналах для балансировки нагрузки, а маппинг моделей позволяет FastGPT показывать одно имя, отправляя провайдеру другую строку id. Для self-hosters на старых версиях прямая настройка всё ещё существует: классическая пара переменных окружения FastGPT направляет платформу на любой OpenAI-совместимый base — OPENAI_BASE_URL и CHAT_API_KEY в окружении docker-compose, с моделями, объявленными в config.json под llmModels. Это работает, но UI-путь — это то, куда переехал проект, и новым деплоям стоит начинать именно с него.
Азиатский ракурс: один баланс для обоих миров моделей.
Пользовательская база FastGPT сильно китаеязычная, и типичный деплой смешивает региональные модели с западными: GLM или Qwen для китайских баз знаний, DeepSeek для объёма, Claude или GPT там, где продукт — это отточенность ответа. При прямом подключении такой микс означает аккаунты у Zhipu, Alibaba, DeepSeek, Anthropic и OpenAI, каждый со своим биллингом, причём некоторые из них неудобно оплачивать с одной или другой стороны мира. Через один канал этот микс — просто список моделей: glm-5.2, qwen3.7-plus, kimi-k2.6, deepseek-v4-flash и claude-haiku-4-5-20251001 бок о бок, один предоплаченный баланс, без требования карты, id прямо из каталога. Команды в Азии получают Claude и GPT без западной карты; западные команды получают китайские модели без региональной регистрации. Одна и та же база знаний может отвечать на китайские запросы через GLM и на английские через Claude, маршрутизируемые по приложению. Если вместо этого вы используете устаревшую настройку через переменные окружения, тот же эндпоинт подключается напрямую; конвенция base URL включает суффикс /v1, и FastGPT добавляет к нему пути маршрута вроде /chat/completions.
# docker-compose environment, pre-AI-Proxy versions
OPENAI_BASE_URL=https://api.apisrouter.com/v1
CHAT_API_KEY=sk-YOUR-APISROUTER-KEY
# models declared in config.json under llmModelsВыбор моделей для баз знаний и flow.
Поскольку каждый включённый id тарифицируется через один ключ, сравнение моделей — это правка настройки узла. Закрепите двух кандидатов в двух копиях одного приложения, прогоните неделю реальных вопросов и прочитайте разбивку по модели в консоли APIsRouter рядом с вашей собственной оценкой качества ответов.
- QA по датасетам и генерация ответов по извлечённым чанкам — это объёмная работа: deepseek-v4-flash и glm-5.2 держат стоимость на вопрос стабильной на двуязычных корпусах.
- qwen3.7-plus и kimi-k2.6 — региональные кандидаты, которые стоит протестировать, когда ответы должны звучать по-китайски естественно; качество генерации у китайских моделей различается сильнее, чем качество retrieval.
- claude-haiku-4-5-20251001 — быстрый западный уровень для деплоев со смешанным языком; переходите на claude-sonnet-4-6 в конкретных приложениях, где качество синтеза — это продукт.
- Узлы workflow срабатывают на каждом прогоне, так что пятиузловой flow умножает то, какой id стоит в каждом узле; ставьте быстрые id в узлы классификации и маршрутизации, а траты — на узел ответа.
- Модели индексации и извлечения настраиваются отдельно от чат-моделей; убедитесь, что эндпоинт обслуживает id embedding, который вы привязываете, прежде чем перестраивать индекс вокруг него.
Оплата по факту · дешевле официальных цен
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Модель | Официальная цена | Наша цена |
|---|---|---|
| GLM-5.2 | $1.14 / $4.00 per M | $1.10 / $4.00 per M |
| DeepSeek V4 Flash | $0.14 / $0.28 per M | $0.10 / $0.30 per M |
| Qwen 3.7 Plus | $0.29 / $1.14 per M | $0.30 / $1.10 per M |
| Kimi K2.6 | $0.95 / $4.00 per M | $1.00 / $4.00 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
Сбои, специфичные именно для FastGPT.
Конвенция base URL сбивает с толку людей, переходящих из других инструментов: FastGPT ожидает base с суффиксом /v1 в поле proxy и сам добавляет /chat/completions, тогда как её форма custom-model (отдельная фича для разовых моделей, обходящих каналы) хочет полный URL запроса, включая /v1/chat/completions. Знайте, в каком поле вы находитесь, прежде чем вставлять значение. Модель, которая есть в канале, но не выбирается в приложениях, значит, что она была добавлена в канал, но не включена на стороне моделей конфигурации; эти два списка раздельны, и тест связности доказывает только канал. Старые туториалы — самая большая опасность. Годы гайдов по FastGPT предполагают sidecar OneAPI и правки config.json; в текущих версиях UI Model Providers заменяет и то, и другое, и смешивание двух подходов (настройка через окружение плюс каналы) заставляет запросы маршрутизироваться туда, куда вы не смотрите. Выберите один слой и настройте его полностью. Ошибки model-not-found — обычная проблема свободного текста: id в канале должен точно совпадать с написанием /v1/models шлюза, включая версионные суффиксы. Копируйте, а не вводите вручную.
Кто направляет FastGPT через шлюз.
- Двуязычные команды, смешивающие GLM, Qwen, Kimi и DeepSeek с id Claude и GPT в одном деплое, с одним балансом и одним логом использования.
- Команды в Азии, которым нужны топовые западные модели на предоплаченном балансе без западной карты, и западные команды, которым нужны китайские модели без региональной оплаты.
- Self-hosters, заменяющие sidecar OneAPI: шлюз обслуживает мультивендорную часть, встроенные каналы FastGPT — часть маршрутизации.
- Агентства, ведущие клиентские базы знаний на FastGPT, измеряя каждого клиента собственным ключом, так что расходы на модели отчитываются сами по проекту.
- Разработчики, сравнивающие модели ответов на фиксированных корпусах, где каждый кандидат — это запись канала, а не аккаунт у вендора.
Проверьте эндпоинт и отладьте первый вопрос.
Сначала curl'ните листинг моделей и скопируйте id из вывода в канал; затем прогоните один chat completion против id, который планируете сделать умолчанием. Если оба проходят, половина со шлюзом доказана. Внутри FastGPT используйте тест связности канала, затем задайте один вопрос в минимальном приложении, прежде чем подключать датасеты. Ошибки аутентификации указывают на ключ канала; not-found — на написание id; ошибки подключения — на proxy URL или egress контейнера, так как до эндпоинта должен дотянуться сервер FastGPT. Если приложение с датасетом падает там, где работает обычное чат-приложение, проблема в собственных привязках моделей датасета, а не в канале. Как только вопросы начинают работать, консоль APIsRouter показывает модель на запрос, счётчики токенов и расходы. Трафик баз знаний — это много небольших запросов с большим объёмом входных данных, и вид использования по ключу — это место, где виден реальный профиль стоимости деплоя, по модели, по дню, китайские и западные id на одной странице.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"glm-5.2",
"messages":[{"role":"user","content":"ping"}]}'Частые вопросы
Как добавить кастомный base URL в FastGPT?
В текущих версиях — через UI: Account, Model Providers, Model Channels, Add Channel с протоколом OpenAI, proxy URL https://api.apisrouter.com/v1, вашим ключом и id моделей. На старых версиях задайте OPENAI_BASE_URL и CHAT_API_KEY в окружении и объявите модели в config.json.
Включает ли proxy URL /v1?
Да, в поле proxy канала вводите base с суффиксом /v1, а FastGPT сам добавляет /chat/completions. Отдельная форма custom-model — исключение: она принимает полный URL запроса, включая /v1/chat/completions. Сверяйте конвенцию с полем, которое используете.
Нужен ли ещё OneAPI вместе с FastGPT?
Нет. Начиная с v4.8.23 FastGPT комплектуется собственным слоем агрегации с управлением каналами в UI, а мультивендорный шлюз покрывает ту часть, за которую отвечал OneAPI. Запуск обоих слоёв одновременно работает, но усложняет рассуждение о маршрутизации; новым деплоям стоит настраивать только каналы.
Может ли FastGPT смешивать китайские и западные модели в одном канале?
Да. Канал пересылает каждый id модели как простую строку, так что glm-5.2, qwen3.7-plus, kimi-k2.6, deepseek-v4-flash и claude-sonnet-4-6 могут делить один канал и один ключ, выбираемые по приложению и по узлу workflow.
Почему модель моего канала не выбирается в приложениях?
Добавление id в канал и включение модели для использования — это раздельные шаги в UI Model Providers. Включите модель в списке моделей, затем снова проверьте выпадающий список приложения или узла; разрешения на модели по приложению также могут фильтровать то, что видит конкретная команда.
Какой документации FastGPT доверять в этом вопросе?
Актуальному разделу о настройке моделей на doc.fastgpt.io. Поверхность настройки FastGPT существенно изменилась в эру v4.8.2x, и старые сторонние туториалы, описывающие sidecar OneAPI или ручную правку блоков llmModels, больше не соответствуют UI-first потоку.