# NextChat 接入指南

NextChat（ChatGPT-Next-Web）是一款开源的跨平台聊天应用，支持网页部署与桌面客户端。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

-   网络连接。
    
-   自行部署时需要 [Docker](https://www.docker.com/) 或 [Node.js](https://nodejs.org/)（任选其一）。
    

## **1. 获取 API Key**

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

## **2. 部署并配置**

NextChat 通过环境变量接入 OpenAI 兼容服务。将 `YOUR_API_KEY` 替换为您的 UModelverse API Key。

### 方式一：Docker 部署

```
docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=YOUR_API_KEY \
  -e BASE_URL=https://api.modelverse.cn \
  -e CUSTOM_MODELS="+claude-sonnet-4-6,+gpt-5.2" \
  yidadaa/chatgpt-next-web
```

部署完成后访问 `http://localhost:3000` 即可使用。

### 方式二：本地运行

在项目根目录创建 `.env.local`，写入以下内容后运行 `yarn dev`：

```
OPENAI_API_KEY=YOUR_API_KEY
BASE_URL=https://api.modelverse.cn
CUSTOM_MODELS=+claude-sonnet-4-6,+gpt-5.2
```

> 说明：`BASE_URL` 填平台根地址（NextChat 会自动补全 `/v1`）。`CUSTOM_MODELS` 用于把 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)加入下拉列表，以 `+模型名` 形式添加，多个用逗号分隔。

## **3. 使用模型**

打开页面后，在对话框上方的模型选择器中切换到已添加的 UModelverse 模型即可开始对话。

## **常见问题**

### 提示认证失败或无法连接？

请逐项确认：

1.  `OPENAI_API_KEY` 来自 UModelverse 平台，复制完整且无空格。
    
2.  `BASE_URL` 为 `https://api.modelverse.cn`。
    
3.  `CUSTOM_MODELS` 中的模型是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，且已在模型选择器中选中。