| name | guide-provider |
| description | 供应商管理指南,包括创建供应商、配置 API Key、密钥轮换 |
| trigger | 用户询问怎么添加供应商、API Key 配置、密钥轮换、供应商 API 地址、怎么接入 OpenAI、怎么配置模型、如何开始使用、首次使用、快速上手 |
供应商管理指南
供应商是 API 密钥的来源,可以包含多个 API Key 进行负载均衡和故障转移。
首次使用三步走
- 添加供应商 → 「供应商管理」→ 新建供应商,填写 API 地址和 Key
- 创建代理 → 「代理管理」→ 新建代理,选择供应商,分配端口(详见
/guide-proxy)
- 启动代理 → 点击代理卡片的「启动」按钮,然后用 curl 或客户端测试请求
配置项详解
| 配置项 | 含义 | 示例/说明 |
|---|
| 名称 | 供应商的显示名称,方便识别 | OpenAI 官方、硅基流动生产 |
| 协议 | API 协议类型,决定请求格式 | OpenAI:兼容 OpenAI 格式的 API
Anthropic:Claude API
Gemini:Google Gemini API |
| API 地址 | 供应商的 API 端点,必须以 /v1 或完整路径结尾 | https://api.openai.com/v1
https://api.siliconflow.cn/v1
https://api.anthropic.com |
| 模型列表 | 该供应商支持的模型名称,支持模型路由 | 输入模型名后按回车添加,如 gpt-4、claude-3-opus |
| API Keys | 访问供应商的密钥,支持多 Key 轮换 | 点击「+ 添加 Key」添加 |
| 适配器 | 国内模型适配器,自动处理协议差异 | qwen、deepseek、kimi、doubao、zhipu、minimax、mimo |
| 能力标签 | 该供应商支持的能力列表 | tools、vision、json 等 |
| Azure 部署 | Azure OpenAI 部署名称 | 仅 Azure OpenAI 需要 |
| Azure API 版本 | Azure OpenAI API 版本 | 如 2024-02-01 |
常用 API 地址参考
| 供应商 | API 地址 | 建议适配器 |
|---|
| OpenAI 官方 | https://api.openai.com/v1 | — |
| Anthropic 官方 | https://api.anthropic.com | — |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta | — |
| 硅基流动 | https://api.siliconflow.cn/v1 | — |
| 阿里云百炼 | https://dashscope.aliyuncs.com/compatible-mode/v1 | qwen |
| 智谱 GLM | https://open.bigmodel.cn/api/paas/v4 | zhipu |
| DeepSeek | https://api.deepseek.com/v1 | deepseek |
| Moonshot (Kimi) | https://api.moonshot.cn/v1 | kimi |
| 字节豆包 | https://ark.cn-beijing.volces.com/api/v3 | doubao |
| MiniMax | https://api.minimax.chat/v1 | minimax |
| 本地模型 (Ollama) | http://localhost:11434/v1 | — |
API Keys 配置详解
| 配置项 | 含义 | 说明 |
|---|
| 密钥内容 | API Key 的完整值 | 粘贴即可,系统不会明文显示 |
| 权重 | 使用频率权重,数字越大使用越多 | 默认 1,设为 2 则该 Key 使用概率翻倍 |
| 状态 | 密钥启用/禁用控制 | 禁用的 Key 不会被使用 |
API Key 轮换机制
当某个 Key 触发限流(429)时,系统会自动:
- 标记当前 Key 为「限流中」
- 切换到下一个可用的 Key
- 3分钟后自动恢复尝试该 Key
创建供应商
- 点击左侧菜单「供应商管理」
- 点击「新建供应商」按钮
- 填写配置(见上方配置项详解)
- 点击「保存」
自动获取模型列表
填写供应商信息(至少一个有效 Key)后,点击「自动获取模型列表」按钮,系统会:
- 调用供应商 API 的 models 端点
- 自动填充支持的模型列表
- 如果失败可手动输入模型名
测试供应商连接
填写完供应商信息后,点击「测试连接」按钮可以:
- 验证 API 地址是否可访问
- 验证 API Key 是否有效
- 返回可用模型列表
密钥健康状态
| 状态 | 含义 | 处理建议 |
|---|
| 正常 | 密钥可用,请求正常 | 无需操作 |
| 限流中 | 触发速率限制,正在等待恢复 | 可添加更多 Key 分散压力 |
| 失效 | 密钥无效或额度用尽 | 更换或充值密钥 |
在「总览」页面可查看所有密钥健康状态。
批量添加 Key
在添加 Key 界面,可以一次粘贴多个 Key(每行一个),系统会自动识别并逐个添加。
常见问题
Q: 请求返回 429 限流怎么办?
- 检查密钥是否额度用尽
- 添加更多 API Key 到供应商池
- 降低请求频率
Q: 如何实现密钥轮换?
在供应商中添加多个 API Key,系统会自动轮换:
- 当前 Key 触发限流时自动切换
- 可设置不同 Key 的权重