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

在 Link 区分客户端费用和 API 用量

Chatbox 或 Cherry Studio 中新增 Link 提供商时，使用本站 Key 和 https://www.aifast.link/v1，并从当前模型目录复制 ID。客户端会员、模型厂商会员和 Link API 余额是不同产品，不能互相抵扣。

先发送短文本，再单独测试附件和工具调用。若使用 Link 月卡，检查该客户端选中的模型是否属于套餐分组，并在用量日志确认扣费；聊天界面出现回答不能证明这次请求使用了订阅额度。

查看 Link 充值与月卡规则

通用配置参数

配置前先验证：

curl https://www.aifast.link/v1/models \
  -H "Authorization: Bearer $AIFAST_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，便于统计、限额和撤销。不要通过公开同步服务、聊天记录或截图传递密钥。

客户端版本与路径核对记录

2026-10-11 对照官方发布源码：Chatbox v1.23.5、Cherry Studio v2.1.6。此处是指定版本的源码核对，不是桌面应用完整验收；菜单、自动拼接和端点配置在其他版本可能不同。原有字段核验日期不据此改成新的桌面实测日期。

Chatbox：API Host 与 API Path 不要重复填写版本路径

本次单独执行了 v1.23.5 的 normalizeOpenAIApiHostAndPath 纯函数，并核对自定义 OpenAI 请求使用 API Host + API Path 拼接。下面是实际函数输出，不涉及 Key 或付费模型调用。

第一行使用默认聊天路径；第二行展示重复 /v1 的配置错误，应把 API Path 改为 /chat/completions 后重新检查。即使路径正确，也必须继续验证模型权限和真实回复。选择 Responses 协议时应核对 /v1/responses，不能照搬聊天端点。

Cherry Studio：确认当前供应商的主端点

v2.1.6 的连接设置按供应商主端点区分通用 API Host 与 Anthropic API Host，并提供请求配置入口。先确认供应商类型，再检查最终请求地址；不要把 OpenAI 聊天、Responses 和 Anthropic Messages 三种协议仅靠更换模型名称混用。

真实接入验收时分别保存：不含密钥的供应商配置、客户端版本、会话选中的模型、最终请求路径、短回复结果，以及对应的 Link 用量日志。连接检查通过只完成其中一部分；本页不以源码截图替代成功聊天截图。

Chatbox v1.23.5 · Chatbox Custom OpenAI · Cherry Studio v2.1.6