API 密钥与 Base URL 填写 · 中转与自建端点配置
API Key 从哪里获取
各主流提供商的 API Key 获取入口：
| 提供商 | 获取页面 | 备注 |
|---|---|---|
| OpenAI | platform.openai.com/api-keys | 需要绑定支付方式 |
| aistudio.google.com/apikey | 免费额度有限 | |
| Anthropic | console.anthropic.com | 需要申请 |
| SiliconFlow / 其他中转 | 各自的控制台 | 通常按充值计费 |
Base URL 的格式规律
不同提供商的 Base URL 格式有规律可循：
OpenAI 官方
https://api.openai.com/v1通用中转端点
大多数中转服务商兼容 OpenAI 格式，通常形式为：
https://<服务商域名>/v1Google Gemini
https://generativelanguage.googleapis.comAnthropic
https://api.anthropic.com自建端点
如果你自己部署了兼容端点，填入对应的完整 URL 即可。
中转服务商常见坑
坑 1：Base URL 末尾要不要加 /v1？
绝大多数中转服务商的接口都要求 Base URL 以 /v1 结尾。但也有少数例外。如果你不确定：
- 先尝试服务商给的官方文档示例
- 不行的话对比加上和去掉
/v1的区别
坑 2：接口格式要选对
很多中转服务商同时支持 OpenAI 格式和 Anthropic 格式，或者只支持其中一个。如果对话报错说接口不兼容，回头检查：
- 你选的接口类型（Chat Completions / Response API / Anthropic / Gemini）
- 中转服务商文档里写的支持格式
坑 3：Response API vs Chat Completions
OpenAI 官方正在从 Chat Completions 迁移到 Response API。如果你用的是：
- OpenAI 官方 API：优先选 Response API
- 大多数第三方中转：用 Chat Completions（兼容性最好）
- 不确定：先用 Chat Completions，如果报错再换
配置提供商高级设置
v2.5.6 新增了提供商高级设置页，可以为特定提供商添加自定义请求头（custom headers）。
这个功能适用于：
- 服务商要求额外的身份验证 Header
- 想添加特定的请求标识
- 代理路由需要
添加自定义请求头
- 打开设置 → 提供商设置
- 点击某个提供商进入详情
- 切换到 高级 标签页
- 点击添加按钮，填写 Header 名称和值
- 保存
常见的自定义 Header 例子：
| Header 名 | 值 | 用途 |
|---|---|---|
X-Custom-Auth | bearer xxx | 额外身份验证 |
X-Provider-Tag | rikkahub-user | 服务商侧的使用标识 |
多个提供商的管理
查看提供商列表
提供商设置页显示所有已配置的提供商，每项显示：
- 名称
- 接口类型
- 是否已启用
禁用但不删除
如果暂时不想用某个提供商但不想重新配置：
- 点击提供商卡片进入详情
- 关闭 启用 开关
- 保存
删除提供商
点击提供商卡片右上角的菜单图标（⋮），选择删除。删除前确认关联的模型也一并清理。
编辑现有提供商
点击提供商卡片直接进入详情页，修改 API Key、Base URL 或高级设置后保存。