渠道概览
渠道是什么
渠道就是「一个上游 Provider 的接入点」。比如:
- 同一个 OpenAI,你可能有官方直连渠道、Azure 自部署渠道、第三方中转渠道
- 同一个 DeepSeek,你有官方渠道和一个代理渠道
每个渠道独立保存凭证、地址、可调用模型、路由权重,用户发起调用时系统按 路由策略 挑选一个最合适的渠道转发。
为什么要建多条渠道
- 冗余:一条渠道挂了(欠费 / 限流 / 维护),自动切别的
- 性价比:便宜渠道优先,贵渠道兜底
- 地域 / 合规:不同地区用不同 Provider
- 同一 Provider 多账号:分散额度、分散风险
渠道的几种状态
| 状态 | 谁改的 | 含义 |
|---|---|---|
| 启用 | 管理员 | 正常参与路由 |
| 手动禁用 | 管理员 | 你点过禁用,路由跳过 |
| 自动禁用 | 系统 | 系统发现错误率过高 / 余额不足 / 超时,暂时跳过;管理员需手动恢复 |
自动禁用是临时熔断,不是永久下线。可以在后台「渠道」列表里点恢复,或运行 渠道测试 通过后自动恢复。
一条渠道包含哪些信息
具体在 新增渠道 页面上看到。简而言之:
- 必填:Provider 类型、Base URL、API Key、可调用模型列表
- 常用:权重 / 优先级、并发上限
- 很少用:自定义请求头、响应 JSONPath
详细字段解释见 新增渠道 页面。
支持哪些 Provider
完整清单见 Provider 全清单。凡是走 OpenAI 兼容协议 的中转站都可以直接复用 openai 类型:填好 base_url 与 models,再通过 model_mapping 校正模型名即可。