NextChat 接入 Nbility:搭一个自己的网页 ChatGPT
第八篇 AI Agent 上手系列:用 NextChat 快速搭建网页聊天助手,配置 Base URL、API Key、模型名和访问密码。
前几篇我们讲了 Hermes、OpenClaw 和 token 成本。这一篇进入更偏“应用落地”的部分:用 NextChat 接入 Nbility,把模型 API 变成一个真正可用的工具。
这篇的目标不是堆概念,而是让你看完能完成三件事:
- 知道 NextChat 适合解决什么问题;
- 知道 Base URL、API Key、模型名应该填在哪里;
- 知道怎么避免 token 被无意义消耗。
NextChat 适合什么场景?
NextChat 适合把大模型能力包装成一个稳定入口。它和纯聊天网页不同,通常会带来更明确的业务场景:知识库、工作流、团队聊天、自动化、客服或群机器人。
典型链路是:
用户 / 触发器 -> NextChat -> OpenAI-compatible API -> Nbility -> 模型 -> 返回结果
这个结构的好处是:应用层负责交互和流程,Nbility 负责统一模型入口、token 和 API Key 管理。
第一步:准备 Nbility API
进入:
https://nbility.dev
准备三样东西:
Base URL: https://api.nbility.dev/v1
API Key: [REDACTED]
Model: 选择你账号里可用的模型名
注意:文章、截图、日志里不要暴露真实 Key。教程里统一写 [REDACTED]。
第二步:部署或打开 NextChat
如果你选择自部署,可以从 Docker 开始。示例命令:
docker run -d --name nextchat -p 3000:3000 \
-e OPENAI_API_KEY=[REDACTED] \
-e BASE_URL=https://api.nbility.dev \
-e CODE=your-access-password \
yidadaa/chatgpt-next-web
不同版本的环境变量名称可能变化,正式部署前建议先看官方文档或当前镜像 README。本文重点是配置思路:只要它支持 OpenAI-compatible / Custom OpenAI endpoint,就可以接到 Nbility。
第三步:配置模型入口
在 NextChat 的模型设置里,通常需要填:
Provider: OpenAI / OpenAI-compatible / Custom
Base URL: https://api.nbility.dev/v1
API Key: [REDACTED]
Model: 你的模型名
如果界面只让你填 OpenAI Key,没有 Base URL,优先查找:
- Docker 环境变量;
- 服务端配置文件;
- 管理员后台;
- “Custom Model Provider” 或 “OpenAI compatible” 选项。
第四步:做一个最小可用测试
先不要一上来就接复杂知识库或自动化。建议先发一条简单请求:
请用一句话说明你当前使用的模型入口是否可用。
然后检查:
- 是否正常返回;
- 是否出现 401;
- 模型名是否 not found;
- 日志里是否把真实 Key 打出来;
- token 消耗是否符合预期。
第五步:再接真实场景
NextChat 的价值不在“能不能聊天”,而在能不能帮你完成固定工作流。你可以从这些场景开始:
- 个人知识库问答;
- 企业 FAQ 客服;
- 每日总结和周报;
- 群聊自动答疑;
- 文档摘要和改写;
- 自动化通知;
- API 调用和数据处理。
token 成本控制建议
NextChat 一旦从 demo 变成日常工具,token 消耗会变得稳定而持续。建议:
- 单独给 NextChat 建一个 Nbility API Key;
- 日常问答用性价比模型;
- 复杂任务再切强模型;
- 知识库/RAG 控制文档切片和召回数量;
- 群聊/自动化默认加触发条件和冷却;
- 日志里不要记录完整 prompt 和 Key;
- 每周看一次消耗趋势。
常见问题
1. 401 unauthorized
大概率是 API Key 错、复制多了空格,或者填成了网页登录 token。
2. model not found
模型名要和 Nbility 后台可用模型一致。不要照抄别的平台模型名。
3. Base URL 到底填 /v1 还是不填?
多数 OpenAI-compatible 应用填:
https://api.nbility.dev/v1
但少数应用会自己拼 /v1,这时可能要填:
https://api.nbility.dev
如果报 404,优先检查这里。
4. 消耗比预期高
看是否开启了知识库、多轮历史、自动总结、插件、工具调用或群聊自动触发。