配置上游端点
在 端点管理 维护上游 API:填写地址与密钥、选转换器、点亮对外模型,并决定是否走全局出站代理。

表单字段
| 字段 | 说明 |
|---|---|
| 名称 | 端点别名,日志与队列中显示 |
| API URL | 上游根地址。默认会附加 /v1/...;路径已含 /v1、/v4 等版本号时自动跳过;末尾加 # 只禁止自动附加版本(仍拼 /chat/completions 等协议路径),例如 https://host/openai# |
| API Key | 上游密钥,界面可切换显示 |
| 锁定模型(可选) | 非空则强制覆盖请求里的 model |
| 备注(可选) | 自由说明 |
| 转换器 | claude(直通)/ openai(转换)/ codex(Responses) |
| 模型清单 | 可手输或点刷新从上游拉取;点击徽章切换 点亮 |
| 启用代理 | 该端点经设置中的全局代理地址出网 |
| 加入快速队列 | 仅已启用端点编辑时出现;打开后进入优先选路子集 |
点亮规则:
- 全部未点亮时默认全部公布
- 点亮任意项后,只公布点亮子集
- 移除模型时会同步从点亮集剔除
选择转换器
按上游真实协议选择:
- claude(直通):上游是 Anthropic Messages
- openai(转换):上游是 OpenAI Chat Completions
- codex(Responses):上游是 OpenAI Responses
选错会导致上游返回协议错误。
实际请求地址 = API URL + 下表路径。根地址已带 /v1、/v4 等版本号,或末尾写了 # 时,不再重复加 /v1:
| 转换器 | 默认拼上 | 已有版本或 # 时 |
|---|---|---|
| claude | /v1/messages | /messages |
| openai | /v1/chat/completions | /chat/completions |
| codex | /v1/responses | /responses |
例如智谱填 https://open.bigmodel.cn/api/coding/paas/v4、转换器选 openai,会请求 .../v4/chat/completions,不必加 #。# 只阻止自动加版本号,仍会拼上 /chat/completions 等路径,不会把整段 URL 原样发出。
配置模型映射
在端点卡片打开 模型映射:
- 打开 启用映射(关闭时保留规则但不改写)。
- 添加入站模型名(手输)与出站模型(下拉,来自点亮模型;未点亮则全部)。
- 可用预设芯片添加入站名,再点 保存。
若提示暂无可用模型,先在端点中点亮模型或填写锁定模型。
出站代理判定
端点 启用代理 与设置里的全局 启用代理 是或关系。转发与拉取模型时:
text
proxy = (useProxy || proxyEnabled) && proxyUrl 非空地址为空时直连;全局地址与测试在设置页的代理卡片。
连通性测试
在端点卡片执行测试,状态写入 testStatus:available / unavailable / unknown。代理未运行时也可作粗略健康参考。应用内 对话 页也可做无工具的连通性试探。
轮换与熔断
启用端点参与选路;存在快速队列成员时只轮询快速队列。熔断阈值与状态机数字见侧栏「轮换与熔断」。
