接入 NextChat

NextChat 适合作为企业内部轻量级对话入口。管理员在服务端配置 UWCode Key 后，员工无需自行填写个人模型账号，即可在同一个界面使用企业分配的模型能力。

适用场景

企业自托管 NextChat，并希望把模型调用统一归集到 UWCode。
管理员统一维护可用模型、访问密码与员工使用入口。
需要在 UWCode 控制台按团队、项目或服务账号统计 NextChat 的调用量。

前提条件

已在 UWCode 控制台创建一个用于 NextChat 的服务账号 Key。
该 Key 已分配可用模型、额度和调用来源策略。
NextChat 使用服务端部署方式，例如 Vercel、Docker 或企业内部容器平台。

服务端环境变量

NextChat 服务端的 BASE_URL 表示 OpenAI 接口代理主机，应用会在请求时拼接 v1/chat/completions 等路径。因此在服务端部署 NextChat 时，建议填写 UWCode 主机地址，不要重复追加 /v1。

OPENAI_API_KEY=uwc-xxxxxxxx
BASE_URL=https://api.uwcode.com
CUSTOM_MODELS=-all,+gpt-4o-mini,+deepseek-v3,+qwen-max,+gemini-1.5-pro
CODE=your-team-access-code
HIDE_USER_API_KEY=1
ENABLE_BALANCE_QUERY=0

配置项	建议值	说明
`OPENAI_API_KEY`	`uwc-xxxxxxxx`	UWCode 为 NextChat 服务账号分配的 Key。
`BASE_URL`	`https://api.uwcode.com`	NextChat 服务端会继续拼接 `/v1/...` 路径。
`CUSTOM_MODELS`	按企业模型清单配置	使用 `-all,+model` 限制员工可见模型。
`CODE`	企业内部访问密码	建议必须配置，避免公开入口被滥用。
`HIDE_USER_API_KEY`	`1`	不允许员工在前端自行填写外部 API Key。

部署步骤

在 UWCode 控制台进入 Key 管理，创建名称为 nextchat-service 的服务账号 Key。
在 NextChat 部署平台中写入上方环境变量。
在 CUSTOM_MODELS 中仅保留企业已采购或已接入 UWCode 的模型。
重新部署或重启 NextChat 服务。
使用企业访问密码进入 NextChat，发起一次普通对话。

验证接入

完成部署后，在 UWCode 控制台检查：

调用日志 中出现来源为 NextChat 服务账号 Key 的请求。
用量统计 中可看到对应模型、Token 和费用数据。
失败率 为正常范围，且未出现 401、403 或模型不存在错误。

# 也可以直接验证 UWCode OpenAI-compatible 入口
curl https://api.uwcode.com/v1/chat/completions \
  -H "Authorization: Bearer uwc-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}'

常见问题

NextChat 报 404 或路径重复：确认服务端 BASE_URL 是否误写成 https://api.uwcode.com/v1。NextChat 服务端配置通常使用主机地址。
员工能填写个人 Key：确认已设置 HIDE_USER_API_KEY=1，并通过访问密码或企业网关限制入口。
模型列表不符合企业策略：使用 CUSTOM_MODELS=-all,+模型名 只展示 UWCode 已授权模型。
控制台看不到请求：确认 NextChat 已重启，并且实际请求使用的是服务端环境变量中的 UWCode Key。

官方依据

NextChat README：环境变量 OPENAI_API_KEY、BASE_URL 与 CUSTOM_MODELS