跳转到内容

Provider 管理

Provider 是上游模型供应商(如 OpenAI、Anthropic、火山引擎)。codingas.com 内置 21 个主流供应商元数据,开箱即用。Provider 管理负责供应商接入与连通性验证。

概念说明
Provider上游模型供应商(元数据位于 data/builtin/vendors/
Channel渠道,绑定 Provider,配置端点与凭证
凭证(Credential)上游 API Key,挂在渠道下,由 ChannelCredentialController 管理

/api/v1/providers(需 Sa-Token 登录态)

方法路径说明
POST/api/v1/providers创建 Provider
GET/api/v1/providers/{id}Provider 详情
GET/api/v1/providersProvider 列表(分页)
PUT/api/v1/providers/{id}更新 Provider
DELETE/api/v1/providers/{id}删除 Provider
GET/api/v1/providers/names所有供应商名称(供前端选择)
POST/api/v1/providers/test-connectivity测试连通性

内置 21 个主流供应商(OpenAI / Anthropic / Google / DeepSeek / 通义千问 / 月之暗面 / 智谱 / 百川 / MiniMax / 腾讯混元 / 火山引擎 / 百度文心 / 讯飞 / 华为盘古 / Azure / AWS Bedrock / 360 智脑 / 零一万物 / Mistral / 阶跃星辰 / xAI),详见 模型与定价

上游 API Key 作为渠道凭证管理,路径为 /api/v1/channels/{channelId}/credentials,支持:

  • 凭证 CRUD(apiKey / priority / weight / description
  • 凭证测试(POST /{id}/test
  • 凭证明文仅详情接口返回(用于复制),存储时 AES-256-GCM 加密

详见 渠道管理 的”凭证管理”。

一个渠道可挂多个凭证(上游 Key),网关按以下策略调度:

  • priority:数值越小越优先(默认 100)
  • weight:同优先级内的流量分配权重
  • 故障转移:L0 容灾在同渠道内按凭证逐个尝试,详见 容灾与高可用

控制台 Channels 模块下管理 Provider 与凭证:

  • 创建渠道时选择 Provider
  • 渠道详情抽屉的”凭证”区域管理上游 Key
  • 连通性测试验证接入

详见 渠道管理控制台快速上手