NextChat 配置 AI API 中转地址教程：API Key、Base URL 与 Claude/GPT 模型设置

NextChat 配置 AI API 的关键，是先确认接口兼容格式，再把 API Key、Base URL 和真实模型 ID 对应起来。对于自行部署的 NextChat，通常通过环境变量统一配置；个人使用也可以在客户端设置中填写自己的密钥。下面以 OpenAI 兼容接口为主，说明完整配置与排错方法。

🧩 NextChat 配置 AI API 前准备什么

• 服务商提供的 API Key
• 与接口格式匹配的 Base URL
• 平台实际开放的模型 ID
• 可编辑环境变量并重新部署的 NextChat 实例，或允许填写自定义密钥的个人客户端

如果还没有服务商，可以先查看AI API 中转平台推荐与价格模型表。Base URL、额度和倍率容易混淆时，先阅读AI API 的 Base URL、额度和倍率解释。

⚙️ 自行部署 NextChat：环境变量怎么填

NextChat 官方当前提供了以下常用环境变量。把示例值替换为服务商实际信息，不要直接复制示例模型名：

OPENAI_API_KEY=sk-your-api-key
BASE_URL=https://api.example.com
CUSTOM_MODELS=-all,+model-id-1,+model-id-2
DEFAULT_MODEL=model-id-1
CODE=your-access-password
HIDE_USER_API_KEY=1

• OPENAI_API_KEY：OpenAI 或 OpenAI 兼容接口的密钥。
• BASE_URL：覆盖默认 OpenAI API 地址，填写服务商要求的基础地址。
• CUSTOM_MODELS：控制模型列表，确保名称与服务商实际 Model ID 一致。
• DEFAULT_MODEL：设置首次打开或新对话默认使用的模型。
• CODE：为公开访问的 NextChat 实例设置访问密码。
• HIDE_USER_API_KEY=1：隐藏用户自行输入 API Key 的入口，适合由部署者统一提供密钥的实例。

在 Vercel、Docker 或其他托管环境修改变量后，需要按部署方式重新构建或重新部署，旧实例不会自动读取所有新配置。官方支持的变量可能随版本变化，建议同时核对 NextChat 环境变量文档和 官方 .env.template。

🧠 CUSTOM_MODELS 与默认模型怎么设置

CUSTOM_MODELS 使用英文逗号分隔多个项目。常用规则如下：

CUSTOM_MODELS=+model-a,+model-b
CUSTOM_MODELS=-old-model
CUSTOM_MODELS=model-id=显示名称
CUSTOM_MODELS=-all,+model-a,+model-b

• +model：增加一个模型。
• -model：隐藏一个模型。
• model=显示名称：保留实际模型 ID，同时修改界面显示名称。
• -all：先隐藏默认模型，再只开放指定模型。

Claude 或 GPT 只是模型系列名称，真正请求时必须使用服务商提供的完整模型 ID。不要根据宣传页自行猜测名称，也不要把一个平台的模型 ID 直接复制到另一个平台。Claude 原生接口与 OpenAI 兼容接口的调用方式也不相同；需要了解 Claude 接入格式时，可参考Claude API 国内接入教程。

🔗 Base URL 要不要加 /v1

没有适用于所有中转服务的统一答案。NextChat 官方把 BASE_URL 定义为 API 基础地址覆盖项，但不同网关对路径的要求不同。有的平台给出域名根地址并由客户端补充路径，有的平台要求配置中包含 /v1。

最稳妥的方法是使用服务商专门为 NextChat 或 OpenAI 兼容客户端提供的地址，然后发送一次最小测试。如果最终请求路径重复出现 /v1/v1，或缺少服务商要求的版本路径，就会返回 404。不要在没有查看文档和错误响应的情况下机械增删 /v1。

🔑 在 NextChat 设置中使用个人 API Key

如果实例允许用户配置自己的密钥，可以打开 NextChat 设置页面，找到模型服务或 API Key 相关选项，填入自己的密钥与接口地址，再选择对应模型。不同版本的字段名称可能略有变化，实际入口以当前界面为准。

不要把主账号的长期密钥输入来源不明的公开 NextChat 网站。更安全的做法是自己部署，或使用可以限制额度、模型、权限和有效期的独立 Key。已经使用 Cherry Studio 的读者，也可以对照Cherry Studio 配置 AI API 教程理解两种客户端的配置差异。

🧭 测试连接与常见错误排查

1. 新建对话，选择刚配置的默认模型。
2. 发送一句简短测试消息，避免一开始使用长上下文或附件。
3. 确认 NextChat 收到正常回复，并在服务商后台看到对应调用记录。
4. 核对模型、Token 用量、倍率和扣费，确认请求确实走到了目标渠道。

• 401：检查 API Key 是否复制完整、是否过期，以及认证方式是否匹配。
• 403：检查账号、分组和模型权限，以及服务商的访问策略。
• 404：检查 Base URL、/v1 路径、接口兼容格式和 Model ID。
• 429：检查余额、速率、并发和渠道容量，降低请求频率后重试。
• 修改后仍调用旧地址：确认环境变量保存成功，并重新构建或重新部署实例。

更详细的状态码定位顺序，可查看AI API 401、403、404、429 错误解决方法。

🛡️ 公开部署 NextChat 的安全建议

• 使用 CODE 设置访问密码，不要把开放实例暴露给所有人。
• 为 NextChat 单独创建低额度 Key，不与其他项目共用主密钥。
• 不要把密钥写入公开 Git 仓库、截图、浏览器前端代码或教程示例。
• 定期检查调用记录；发现异常后立即撤销旧 Key 并生成新 Key。

💡 常见问题