Skip to content

配置上游端点

端点管理 维护上游 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 原样发出。

配置模型映射

在端点卡片打开 模型映射

  1. 打开 启用映射(关闭时保留规则但不改写)。
  2. 添加入站模型名(手输)与出站模型(下拉,来自点亮模型;未点亮则全部)。
  3. 可用预设芯片添加入站名,再点 保存

若提示暂无可用模型,先在端点中点亮模型或填写锁定模型。

出站代理判定

端点 启用代理 与设置里的全局 启用代理 是或关系。转发与拉取模型时:

text
proxy = (useProxy || proxyEnabled) && proxyUrl 非空

地址为空时直连;全局地址与测试在设置页的代理卡片。

连通性测试

在端点卡片执行测试,状态写入 testStatusavailable / unavailable / unknown。代理未运行时也可作粗略健康参考。应用内 对话 页也可做无工具的连通性试探。

轮换与熔断

启用端点参与选路;存在快速队列成员时只轮询快速队列。熔断阈值与状态机数字见侧栏「轮换与熔断」。