Docs

简体中文

English

简体中文

English

外观

新增渠道 ​

本页解释「新建一条渠道」时每一项是什么、从哪里获取、设置后会改变什么。

后台 → 渠道 → 新增，会打开如下表单。

必填项 ​

Provider 类型 ​

  • 是什么：上游是哪个服务商（OpenAI / Anthropic / Azure / 智谱 / DeepSeek / Ollama…）
  • 从哪里来：在下拉列表里选
  • 设置后影响：决定请求协议（OpenAI 兼容 / Anthropic Messages / Azure 自定义）。选错就调不通

渠道名称 ​

  • 是什么：给渠道起个名字，仅展示
  • 从哪里来：自己起（如「OpenAI 官方 / Azure East / 智谱生产」）
  • 设置后影响：仅展示用，不影响通信

Base URL ​

  • 是什么：上游 Provider 的接入地址
  • 从哪里来：
    • OpenAI 官方：https://api.openai.com/v1
    • Azure OpenAI：你的部署页有形如 https://<resource>.openai.azure.com/openai/deployments/<dep> 的端点
    • 第三方中转：服务商提供的接入地址
  • 设置后影响：错就 404。注意是否需要带 /v1，不同 Provider 习惯不同

API Key / 凭证 ​

  • 是什么：上游 Provider 给你的访问令牌
  • 从哪里来：上游 Provider 控制台 → API Keys / Access Tokens
  • 设置后影响：错就 401
  • 注意：复制完整、不要带前后引号 / 空格 / 换行

模型列表 ​

  • 是什么：这条渠道能调用哪些模型（多选）
  • 从哪里来：下拉里的选项来自 模型定价 中已启用的模型
  • 设置后影响：不勾的模型不会被路由到这条渠道
  • 注意：勾之前先在「模型定价」里把价格维护好，否则调用成功但不会扣费

常用项 ​

权重 / 优先级 ​

  • 是什么：数字越大越容易被选中
  • 建议：把「便宜快稳」的渠道权重设高，「贵慢备」的设低

并发上限 ​

  • 是什么：同时跑多少请求
  • 设置后影响：超过会自动熔断 / 重试别的渠道
  • 建议：与上游 Provider 给你的 RPM / TPM 上限匹配

启用 / 禁用 ​

  • 是什么：开关
  • 设置后影响：禁用后路由跳过
  • 建议：新建后先点 渠道测试 通过再启用

进阶项（大多数情况不需要动） ​

自定义请求头 ​

仅当上游要求特殊 Header 时填。例如 Azure 早期需要 api-key 而非 Authorization。

响应 JSONPath ​

上游返回结构非标准时用于提取错误信息。99% 留空即可。

重试次数 / 超时秒数 ​

Provider 慢或经常失败时再调。

完成后的下一步 ​

  1. 在新增页底部点「保存」
  2. 跳转到渠道详情页
  3. 点 [渠道测试] → 输入一个模型名 → 看返回是否成功
  4. 测试通过后启用该渠道

相关文档 ​