AI 模型配置说明

接口支持

当前支持 DeepSeek、OpenAI、阿里通义千问、智谱 GLM 接口及私有化API、本地模型接口。每个厂商模型只保留较新的模型。

点击查看官方模型配置说明点击收起官方模型配置说明

官方模型配置

打开 AI 模型设置。
点击“添加模型”，选择 DeepSeek、OpenAI、Qwen 或智谱 GLM。
展开连接，确认 Base URL。
鉴权方式选择 Bearer API Key。
粘贴该供应商的 API Key。
选择 Auto 模型和深度模型。
点击“测试连接”。
测试成功后点击“保存设置”。

提示： 其他保持默认即可，需要自定义，请参考 参数说明（tab）。
"继承档案默认值"是挡位弹窗中的一个选项，意思是： 直接使用内置档案中的默认值。具体各模型默认值见 参数说明中全局默认值

点击查看自定义 API 配置说明点击收起自定义 API 配置说明

自定义 API 配置说明

点击“添加模型”，选择“自定义 API”。
修改连接名称。（如自定义GPT）
选择协议模板，支持 OpenAI Chat 兼容、OpenAl Responses 兼容、DeepSeek 兼容、百炼 Chat 兼容、百炼 Responses 兼容。多数兼容 OpenAI 的中转站先选 OpenAI Chat 兼容。一般默认，按需选择。
填写 Base URL。
填写 API Key。
手动添加模型 ID，或点击“导入模型”从 /models 自动导入。

添加模型

模型 ID 和模型名称的作用不同，填写要求也不同：
模型名称（Name） — 可以随便写
仅用于界面显示，方便你自己识别
比如写GPT-5.5 我的中转、便宜模型都行.
模型 ID 不能随便写，必须准确
它会作为 API 请求中的 model 参数直接发给你的模型站
必须与模型站实际支持的模型标识符完全一致（区分大小写）
比如中转站用的是 gpt-5.5，你就必须填 gpt-5.5，填 GPT-5.5 或 gpt5.5 都会报错
建议： 如果不确定中转站的模型 ID 是什么，先点"导入模型"按钮自动获取，或者在中转站后台查看它支持的模型列表，复制准确的 ID。

特别说明

自定义 API 的"导入模型"功能通过后端调用 GET {BaseURL}/models 接口来获取模型列表，支持 OpenAI 兼容的两种 JSON 响应格式： 格式 1：OpenAI 标准格式（data 数组）

json

{
  "data": [
    { "id": "gpt-5.5" },
    { "id": "gpt-4o" }
  ]
}

格式 2：替代格式（models 数组）

json

{
  "models": [
    { "id": "gpt-5.5" },
    { "id": "gpt-4o" }
  ]
}

提示

两种格式可以共存，系统会合并去重。核心要求是每个模型对象必须包含 id 字段。 前提条件：

已填写 Base URL
如需鉴权（authMode: bearer），需已填写 API Key
目标服务的 /models 端点需返回上述格式之一
大部分 OpenAI 兼容的中转站（如 One API、New API 等）都支持格式 1，所以基本都能正常导入。

选择 Auto 模型和深度模型。
能力策略先保持“保守安全模式”。
点击“测试连接”。
测试成功后点击“保存设置”。
确认基础调用稳定后，再考虑配置“能力/挡位”和执行能力验证。

点击查看本地 Ollama 类模型配置说明点击收起本地 Ollama 类模型配置说明

本地 Ollama 类模型配置说明

配置本地 Ollama 类模型（其他选项基本和自定义API一致）

确认本地服务已启动，并提供 OpenAI 兼容接口。
点击“添加模型”，选择“本地模型”。
默认 Base URL 为 http://127.0.0.1:11434/v1，按实际端口调整。
鉴权方式保持“无需鉴权”。
将模型 ID 改成你本地实际模型名，例如 qwen3。
Auto 模型和深度模型可以先选同一个模型。
点击“测试连接”。
测试成功后点击“保存设置”。

点击查看常见问题点击收起常见问题

常见问题

点击“保存设置”前，前端会先做一次校验，后端也会再次校验。常见不能保存的原因包括：

问题	处理方式
连接 ID 为空或重复	删除异常连接，或重新添加连接
连接名称为空	给自定义/本地连接填写名称
Base URL 为空	填写服务商 API 基础地址
官方连接协议被改	恢复官方默认连接，或改用自定义 API
模型 ID 为空或重复	补全或删除重复模型
Auto/深度模型不存在	在模型列表里添加对应模型，或重新选择
Bearer 鉴权但没有 API Key	填写 API Key，或改成无需鉴权
当前连接未启用或不可用	至少保留一个可用连接，并设为当前连接
自定义能力参数不在白名单	使用界面下拉选项，不要手工改 JSON 为未知路径

点击查看502错误原因点击收起502错误原因

502错误原因

502 有三种可能原因：

来源	代码位置	含义
HTTP 请求失败	第 37-40 行	后端无法连接到上游 API（DNS 失败、超时、连接被拒绝）
上游返回非 2xx	第 43-46 行	API 地址能访问但返回了错误（如 401、404）
JSON 解析失败	第 56-58 行	API 返回的不是标准的 OpenAI 格式模型列表

请确认以下几点：

你的 Base URL 填的是什么？（例如 https://api.deepseek.com/v1）
这个 API 是否支持 /models 端点？ 有些中转站不支持该端点
可以在浏览器里手动访问 {你的BaseURL}/models 看是否返回 JSON 格式的模型列表