API 配置
API 配置
通过 「模型设置」→「新建 API」，你可以将任意兼容的模型服务添加到 NextAI 中使用。
支持自定义 API，也支持常见厂商（如 Qwen、Gemini、Anthropic、Ollama 等）。
一、创建新的 API 提供方
- 打开 NextAI → 点击顶部悬浮岛 → 点击打开菜单栏 → 进入 设置 → 接口设置。
- 点击右上角 “＋” 新建 API。
将出现一个表单界面，包含以下项目：
| 字段 | 说明 |
|---|---|
| 是否启用 | 打开后该提供方可在会话中被选择。 |
| 类型 | 选择模型服务类型：自定义 API / Qwen / Gemini / Anthropic / Ollama。 |
| 显示名称 | 自定义此提供方的名称（如 OpenAI、DeepSeek、My Gateway 等）。 |
| API 地址 (Base URL) | 模型的接口地址，例如：https://api.openai.com/v1。 |
| API 密钥 (API Key) | 从对应服务商控制台复制粘贴你的密钥。 |
💡 提示：
- “自定义 API” 模式可兼容大多数 OpenAI 协议接口。
- 选择特定厂商（如 Qwen、Gemini 等）。
填写完成后，点击右上角 💾 保存。
二、常见服务示例
| 服务商 | Base URL 示例 |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| DeepSeek | https://api.deepseek.com |
| Qwen (通义千问) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Moonshot | https://api.moonshot.cn/v1 |
| 智谱 (GLM) | https://open.bigmodel.cn/api/paas/v4 |
| Ollama | 本地部署地址，如 http://127.0.0.1:11434/api |
三、保存与使用
- 点击 保存 后返回聊天界面。
- 新建对话时即可选择该模型提供方；
若仍提示 “请先添加模型提供方”，请确认：- 提供方已启用；
- 地址与密钥均正确；
- 网络能正常访问该 API 域名。
四、安全建议
- API Key 仅保存在本机，不会上传至云端。
- 建议为每台设备单独创建密钥，并定期轮换。
- 粘贴密钥后，检查是否多出空格或换行。
- 不建议将代理地址直接写入 Base URL。
五、验证连接（可选）
你可以使用 curl 或其他工具验证是否连通：
bash
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"若返回模型列表，说明连接成功； 如出现 401/403/404 等错误，可参考下方排查表。
六、添加模型并启用
完成 API 添加后，你需要为该接口配置一个或多个模型，才能在会话中使用。
- 打开 设置 → 接口设置；
- 在已添加的 API 卡片（例如 Qwen）中，点击 「＋ 新建模型」；
- 填写以下字段：
| 字段 | 说明 |
|---|---|
| 是否启用 | 开启后该模型可用于聊天。 |
| 多模态 | 若模型支持图像或语音输入，可开启此选项。 |
| 显示名称 | 在界面中显示的模型名称（例如 plus、turbo、glm-4 等）。 |
| 最大 Token 数 | 控制模型的上下文长度（默认 2048，可按模型上限调整）。 |
| 模型 ID | 必填，填写服务商提供的模型 ID（例如 gpt-4-turbo、qwen-turbo、gemini-pro 等）。 |
填写完毕后点击右上角 💾 保存。
保存成功后，模型会出现在对应的 API 卡片下，可通过启用/禁用开关控制是否在会话中可选。
常见模型 ID 示例
| 服务商 | 模型 ID | 特点 |
|---|---|---|
| OpenAI | gpt-4-turbo / gpt-3.5-turbo | 支持多模态、强大通用能力 |
| DeepSeek | deepseek-chat / deepseek-coder | 支持中文优化和代码生成 |
| Qwen | qwen-turbo / qwen-plus | 通义千问系列模型，性能均衡 |
| Gemini | gemini-pro | Google 多模态模型 |
| Anthropic | claude-3-opus / claude-3-haiku | 高质量英文理解与生成 |
| Ollama | 例如 llama3 / mistral / phi3 | 本地模型，离线可用 |
小贴士
- 每个 API 可添加多个模型，方便快速切换。
- 模型与 API 是一对多关系，删除 API 会同时移除其下模型。
- 对于同厂商不同接口（如代理地址），可建立多个 API 配置并独立添加模型。
- 若模型支持多模态（如 GPT-4 Vision、Gemini Pro），可开启 多模态开关。
代理与网络小贴士
- 若你在本机开启了全局代理（如
127.0.0.1:7890/7897），确保系统网络设置或代理软件对 NextAI 生效； - 公司/校园网络可能对外域名做了限制，建议在 家庭/移动网络 下测试；
- 避免将代理地址直接填入 Base URL，Base URL 应始终是服务商的 API 域名。