提供商高级设置 · 自定义请求头与 Request Headers

为什么要自定义请求头

默认情况下，RikkaHub 会按标准格式发送请求。但某些场景需要在 HTTP 请求里加入额外的 Header：

• 服务商要求额外的身份验证头（除了 API Key）
• 想添加请求标识，在服务商后台区分自己的请求
• 代理 / 中继路由需要特定头来路由请求
• 企业端点需要自定义安全头

v2.5.6 新增的提供商高级设置页让这件事变得直观。

添加自定义请求头

步骤

1. 打开 设置 → 提供商设置
2. 点击一个已配置的提供商，进入详情页
3. 切换到 高级 标签页
4. 点击 + 添加一条 Header
5. 填写 Header 名和值（都是自由文本）
6. 保存

注意事项

• Header 名大小写不敏感（HTTP 标准），但建议按服务商文档的原始写法
• Header 值直接嵌入请求，不会额外加密。如果值是敏感信息（如 token），谨慎配置
• 自定义 Header 会附加到该提供商的所有请求（对话、OCR、记忆提取等）

与 MCP 服务器请求头的区别

RikkaHub 有两处可以配置自定义请求头，不要搞混：

如果你想精细控制：某个特定 MCP 服务器的 token 应该只配置在 MCP 设置里；某个助手专属的 header 应该只在助手设置里配；通用的提供商级 header 才在提供商高级设置里配。

其他提供商设置

启用 / 禁用提供商

提供商详情页顶部有一个主开关。关闭后：

• RikkaHub 关闭该提供商的所有连接
• 该提供商的所有模型从模型选择器中隐藏
• 已绑定该提供商模型的助手 / 默认模型会显示"不可用"

编辑 Base URL 和 API Key

提供商详情页随时可以修改 Base URL 和 API Key。保存后立即生效，无需重启 app。

接口格式切换

如果一开始选错了接口格式（Chat Completions vs Response API vs Anthropic vs Gemini），在提供商详情页也可以切换。注意：切换格式可能导致现有模型 ID 不可用——建议切换后重新拉取模型列表。

建议：保持提供商列表干净

配置多个提供商后，记得定期清理不常用的。模型选择器里列的提供商和模型越多，越容易搞混哪个是哪个。一个实用策略：

• 主力对话提供商：1-2 个（比如一个 OpenAI 官方 + 一个 SiliconFlow）
• 备用提供商：1-2 个（比如 Anthropic Claude）
• 测试 / 临时：用完就删除

进阶：助手级 HTTP 覆盖

在助手设置（设置 → 助手 → 某个助手 → HTTP 覆盖标签页）中，还可以为单个助手配置额外的自定义头（customHeaders）和自定义请求体字段（customBodies）。这些会合并到每次对话请求中，适合：

• 某个助手需要独立的身份验证
• 某个助手需要传递额外的提供商特定参数（RikkaHub 界面没有暴露的）

优先级：助手级 customHeaders 会附加到提供商级 headers 之上（不是覆盖），两者都生效。