添加第一个 AI 提供商 · 预设与自定义端点
你需要准备什么
在开始之前，确保你有至少一个 AI 提供商的以下信息：
| 信息 | 说明 | 示例 |
|---|---|---|
| API Key | 提供商发放的认证密钥 | sk-xxxxxxxxx |
| Base URL | 提供商的 API 端点（部分不需要） | https://api.openai.com/v1 |
| 接口类型 | OpenAI Chat Completions / OpenAI Response API / Gemini / Anthropic | 见下方详解 |
进入提供商设置
- 打开 RikkaHub 主界面
- 从左侧滑开历史抽屉
- 点击底部操作栏的 设置 图标（齿轮）
- 从设置列表中选择 提供商设置
选择一个预置提供商
RikkaHub 预置了主流提供商，直接点击进入填写：
OpenAI
最主流的接口格式。如果使用 OpenAI 官方 API，推荐优先使用 Response API（OpenAI 官方新格式）；如果通过第三方中转或兼容端点，用传统 Chat Completions。
Google Gemini
Google 自家的 Gemini 格式，专门用于 Gemini 模型。需要 Google AI Studio API 密钥。
Anthropic Claude
Anthropic 自家的格式。除了 Claude 系列，还有一些其他模型也使用这个格式。
创建自定义提供商（转发 / 兼容端点）
如果你使用的是第三方中转或自建端点：
- 在提供商设置页点击右上角 + 按钮
- 选择接口类型（通常是 Chat Completions）
- 填写提供商名称（自由填，方便自己识别）
- 输入 Base URL（例如
https://your-relay.example.com/v1） - 输入 API Key
- 点击保存
API 密钥的安全处理
RikkaHub 对 API 密钥的处理方式值得你放心：
- 本地存储：密钥直接存储在你的 Android 设备本地数据库，不上传任何中间服务器
- 直接传输：每次请求从本地数据库读取密钥，直接发送到你配置的 Base URL
- 界面遮蔽：配置界面中 API Key 默认被遮蔽，眼睛图标可以临时显示
- 备份加密：如果你导出备份，密钥会包含在 ZIP 中——妥善保管备份文件
像对待密码一样保护你的 API 密钥。不要分享给他人，也不要粘贴到不受信任的应用中。
三种接口类型详解
OpenAI Chat Completions（最常用）
传统接口，目前最流行、兼容性最好。绝大多数中转服务商默认提供这个接口。RikkaHub 默认就是这个格式。
OpenAI Response API（OpenAI 官方新格式）
OpenAI 官方已经优先使用这个接口。如果你使用的是 OpenAI 官方 API 或支持 Response API 的中转，勾选"使用 Response API"即可切换。
Google Gemini 格式
仅用于 Google Gemini 系列模型，需要 Google AI Studio 密钥。支持 Gemini 特有的 Interactions API。
Anthropic 格式
Anthropic Claude 系列使用。部分其他模型也兼容这个格式。
测试连接
目前 RikkaHub 在保存提供商配置后不会主动发送测试请求，你可以在配置提供商 → 模型页面添加一个模型后直接进入对话发送消息来验证。如果连接有问题（URL 错、密钥错、网络不通），对话中会立即显示错误信息。