客户端配置教程
选择您使用的客户端，查看详细配置步骤
通用配置信息
所有支持的客户端都需要以下两项基本信息：
API 地址（服务器地址）
https://gemini.bbhttp.com
根据您使用的客户端，可能需要在地址后添加 /v1 路径
API 密钥
示例: sk-abc123def456
从管理员处获取您的专属 API 密钥
提示：不同的客户端软件可能使用不同的名称来称呼这两个配置项，例如"服务器地址"、"API 端点"、"Base URL"、"API基础URL"等都是指 API 地址。
选择您的客户端
CherryStudio 是一款 Windows 桌面客户端，界面简洁，功能强大。
打开设置
点击左下角的设置图标（齿轮形状）
添加提供商
在"提供商"设置中，点击添加自定义提供商
填写配置信息
- 名称：自定义名称（如"我的服务"）
- Base URL：
https://gemini.bbhttp.com（不要带 /v1） - API Key：填入您的 API 密钥
保存并测试
点击保存后，选择该提供商即可开始使用
Chatbox 是一款跨平台的桌面客户端，支持 Windows、macOS 和 Linux。
打开设置
点击左下角的设置按钮
添加 API 提供商
在"API 提供商"选项中，选择OpenAI API Compatible或自定义
配置服务器信息
- API Base URL：
https://gemini.bbhttp.com（不要带 /v1） - API Key：填入您的 API 密钥
选择模型
在模型选择中，选择或手动输入支持的模型名称
SillyTavern 是一个基于 Web 的 AI 前端界面，功能丰富。
打开设置
点击右上角的设置按钮
选择 Chat Completion 来源
在"Chat Completion 来源"下拉菜单中，选择OpenAI
配置 OpenAI 设置
- OpenAI API Base URL：
https://gemini.bbhttp.com（不要带 /v1，SillyTavern 会自动添加） - OpenAI API Key：填入您的 API 密钥
保存设置
点击页面底部的保存设置按钮
NextChat（原 ChatGPT-Next-Web）是一个跨平台的 Web 客户端。
打开设置
点击页面上的设置图标
配置自定义端点
首先勾选Custom Endpoint
- OpenAI Endpoint：
https://gemini.bbhttp.com（不要带 /v1） - API Key：填入您的 API 密钥
设置模型名称
在模型设置中输入支持的模型名称
OMate 是一款功能丰富的 AI 对话客户端应用。
打开 API 设置
进入API 设置页面
添加提供商
点击添加提供商或自定义提供商
配置 API 信息
- 名称：自定义名称（如"我的服务"）
- API规范：选择 OpenAI
- API密钥：填入您的 API 密钥
- API基础URL：
https://gemini.bbhttp.com/v1（需要带 /v1） - 对话模型：填入模型名称（如 gemini-2.5-flash）
Tavo 是一款支持自定义 API 的 AI 对话客户端。
打开设置
点击左上角的设置按钮
进入 API 连接
选择API连接 → 点击新建
配置自定义服务
- 模型平台：选择 自定义（OpenAI 协议）
- API密钥：填入您的 API 密钥（如需要）
- API基础URL：
https://gemini.bbhttp.com/v1（需要带 /v1） - 模型名称：根据服务文档选择模型名称
连接提示：如果连接不上，确认 URL 末尾有 /v1，而不是 /chat/completions
小懿是一款移动端 AI 角色扮演对话客户端，支持 iOS 和 Android。
打开用户页面
进入应用的用户页面
打开 API Key 管理
点击apikey管理进入配置页面
配置 API 信息
- API Key：填入您的 API 密钥
- 请求地址：
https://gemini.bbhttp.com/v1（需要带 /v1）
重要提示：不同客户端对 Base URL 的要求不同喵～
- 不需要 /v1：CherryStudio、Chatbox、SillyTavern、NextChat
- 需要带 /v1：OMate、Tavo、小懿
支持的 AI 模型
配置完成后，您可以选择以下任意模型开始使用：
标准模型
适用于日常对话、问答、内容创作等常规场景
Hajimi 模型
适用于某些特殊场景,抗截断,抗空回,请根据实际情况使用
推荐：日常对话推荐使用 gemini-2.5-flash，响应速度快。复杂任务推荐使用 gemini-3-pro，效果更好。
常见问题
连接服务器失败怎么办？
请检查以下几点：
- 确认服务器地址是否正确
- 确认服务器正在运行且可以访问
- 确认是否需要带 /v1 路径
- 如果使用防火墙，请确保允许访问该端口
提示 API 密钥无效？
请确认：
- API 密钥是否完整复制，没有多余的空格
- 密钥格式是否正确（以
sk-开头） - 密钥是否已激活（首次使用会自动激活）
为什么看不到模型列表？
某些客户端需要手动输入模型名称。请参考上方的"支持的 AI 模型"列表，手动输入模型名称。
可以同时使用多个客户端吗？
可以！同一个 API 密钥可以在多个客户端中使用，但请遵守使用规则，避免超过配额限制。
需要帮助？
如果按照以上步骤配置后仍然无法使用，请联系服务管理员获取帮助。
联系管理员：请提供您使用的客户端名称、遇到的问题和错误提示（如果有）。