接入模型供应商
什么时候用
当你需要接入一个新的大模型服务提供商时使用。平台支持多种主流模型服务，包括 OpenAI、Azure OpenAI、Anthropic、DeepSeek、火山方舟等，也支持自定义 OpenAI 兼容接口。每个 Provider 承载连接信息（URL、API Key、驱动类型），一个 Provider 下可以配置多个具体模型。
你需要准备
- 准备好对应模型服务的 API Key
- 确认 API 服务地址（api_base）
- 了解该服务支持的模型名称
操作步骤
第 1 步：进入模型管理页面
左侧菜单 -> 模型管理。
页面以列表形式展示你已配置的 Provider。点击右上角「新增供应商」按钮，进入创建表单。
第 2 步：填写供应商信息
表单包含以下字段：
| 字段 | 怎么填 | 说明 |
|---|---|---|
| 名称 | 必填，如「OpenAI 官方」、「我的代理」 | 同一空间内唯一，便于你识别 |
| 类型 | 必选，从下拉列表选择 | 如 OpenAI、OpenAI Compatible、DeepSeek、Anthropic 等 |
| API Base URL | 可选 | 填写服务地址，如 https://api.openai.com/v1 |
| API Key | 新建时必填，编辑时可选 | 密钥加密存储，保存后不再明文展示 |
编辑时的特殊行为： 编辑已有 Provider 时，API Key 留空表示不修改原有 Key，只有填入新值才会覆盖。
填完点击「确认」保存。
第 3 步：编辑或删除供应商
在供应商列表中，你可以：
- 点击「编辑」修改已有 Provider 的配置
- 点击「删除」移除该 Provider（注意：删除前请确认没有 ModelItem 在使用它）
怎么验证成功了
- 回到模型管理页面，能看到刚创建的 Provider 在列表中
- 点击「模型管理」展开该 Provider，能看到关联的 ModelItem（如果已添加）
- 可以为该 Provider 添加模型或尝试自动获取模型功能
常见问题
创建/编辑时返回 422
可能是以下原因：
- api_base URL 格式不合法（需要带上协议，如
https://） - 名称与同下已有 Provider 冲突
- 必填字段未填写
API Key 留空报错
编辑时可以留空表示不修改，但新建时必须填入有效的 API Key。
删除 Provider 时报错
说明该 Provider 下仍有 ModelItem 在使用。请先删除关联的 ModelItem，或转移到其他 Provider 后再删除。
API Key 保存后看不到明文
这是正常的安全设计。密钥加密存储，仅返回 已配置/未配置标记 标记表示是否已配置。
深入
核心概念
Provider（提供方）
Provider 代表一个上游大模型服务提供商。它承载了连接信息——URL、API Key、驱动类型等。
常见的 Provider 类型：
| 类型 | 说明 | 典型 API 地址 |
|---|---|---|
| OpenAI | OpenAI 官方 API | https://api.openai.com/v1（默认） |
| OpenAI Compatible | 兼容 OpenAI 接口的第三方服务 | 你的服务地址 |
| Anthropic | Anthropic Claude | https://api.anthropic.com（默认） |
| Azure | Azure OpenAI 服务 | https://xxx.openai.azure.com |
| Gemini | Google Gemini | https://generativelanguage.googleapis.com（默认） |
| DeepSeek | DeepSeek | 默认为 DeepSeek 官方地址 |
| 其它 | 直接透传给 LiteLLM | 你的自定义地址 |
字段含义速查表
Provider
| 字段 | 说明 |
|---|---|
| 名称 | Provider 显示名称，同租户唯一 |
| 类型 | openai / openai_compatible / anthropic / azure / gemini / deepseek 等 |
| API Base URL | 上游服务地址，写入时 URL 校验 |
| API Key | 上游认证密钥 |
| 模型别名映射 | 可选，模型名到别名的映射 |
权限边界
| 操作 | 谁可以 |
|---|---|
| 创建/修改/删除 Provider | 租户管理员 |
常见坑
Provider 删除前的检查
删除 Provider 前请先确认没有 ModelItem 归属它，否则会报错。
排错速查
| 症状 | 可能原因 | 排查路径 |
|---|---|---|
| 创建 Provider 返回错误 | api_base URL 格式不合法 | 检查 URL 格式，需要带上协议（https://） |
- 添加模型或自动获取模型：参见「添加与配置模型」