Chatbox 与 Cherry Studio 接入 AI快站配置教程

通用配置参数

配置前先验证：

curl https://www.aifast.club/v1/models \
  -H "Authorization: Bearer $API_KEY"

Chatbox 配置思路

1. 打开模型供应商或模型设置。
2. 选择 OpenAI API 或 OpenAI Compatible 自定义服务。
3. 填入 API Key 和 Base URL。
4. 手动添加真实模型 ID，或刷新模型列表。
5. 保存后新建会话进行最小测试。

如果 Chatbox 会自动追加 /v1，应根据连接测试或请求日志调整地址，避免 /v1/v1。

Cherry Studio 配置思路

1. 进入“设置 / 模型服务”。
2. 添加自定义供应商。
3. 选择 OpenAI 兼容方式。
4. 填写 API Key 和 API 地址。
5. 使用“管理”或“添加模型”功能录入真实模型 ID。
6. 执行连接检查，再将模型设为助手默认模型。

客户端界面会更新。如果菜单名称与本文不同，应寻找“模型服务”“供应商”“API 地址”“自定义模型”等同类字段。

连接测试通过但无法聊天

连接测试可能只检查域名、认证或模型列表。继续检查：

• 会话实际选择的模型是否与已添加模型一致。
• 模型 ID 是否包含多余空格或中文名称。
• 请求是否进入 /v1/chat/completions。
• 当前模型是否支持图片、工具调用或长上下文。

401、404 和 model not found

• 401：检查 API Key 和 Bearer 认证。
• 404：检查 Base URL 与客户端自动拼接规则。
• model not found：重新查询 /v1/models，复制真实 id。
• 返回 HTML：请求没有进入 API 路由。

多设备使用

不同设备使用独立 Key，便于统计、限额和撤销。不要通过公开同步服务、聊天记录或截图传递密钥。