AICLUB Credits

AICLUB Credits

WorkBuddy 使用教程

1. 购买后找到 API Key

打开购买积分，选择需要的套餐。当前淘宝订单由阿奇索自动发货；付款后在淘宝订单详情的电子凭证、手淘卡片或旺旺消息中查看 API Key 或提取入口。

已付款但没找到 Key，先核对原订单，不要重复购买。联系店铺客服时提供订单号和发货页面截图，完整 API Key 请遮住。

官网支付宝是否开放，以购买页当时显示的入口为准。没有扫码入口时，请走淘宝购买。不要向个人静态收款码转账后等待自动到账。

2. 启用 API Key，只保留一把 Key

  1. 打开启用页面，粘贴首次购买收到的 API Key。
  2. 点击“启用 API Key”，等待显示到账积分。
  3. 保存这把 API Key；它会一直用于查询、配置、调用和充值。
  4. 到积分查询确认余额和有效期。

同一把 API Key 可以用于多个模型和你的多台设备，额度共用。后来购买的套餐用于给原 Key 增加额度，不会替换原 Key。

3. 一键配置 WorkBuddy / CodeBuddy

  1. 打开生成配置，输入已启用的 API Key 并生成配置（如发货消息里有“一键配置链接”，点开即自动完成这一步）。
  2. 点击“检查 API 连接”。该检查不扣积分；通过表示账户认证和模型目录正常。
  3. 选择 WorkBuddy 或 CodeBuddy，点击“下载一键安装包 (Windows)”。
  4. 完全退出所选客户端，直接双击下载的 .bat 文件，等待窗口显示“安装完成”。
  5. 重新打开客户端，在自定义模型里选择带 AICLUB 前缀的显示名称，发送一条普通文字消息。

Windows（推荐，无需解压）

下载得到的是单个 AICLUB-Credits-*-Windows一键安装.bat 文件，双击运行即可，不需要解压任何压缩包。旧配置会自动备份，其他自定义模型会保留。如被 SmartScreen 拦截，点击“更多信息 → 仍要运行”（脚本由本站生成，仅写入客户端模型配置）。需要撤销时重新下载 ZIP 包运行 02-Restore-*.cmd，或联系客服。

macOS

下载 macOS ZIP 安装包，解压后右键打开 01-Install-WorkBuddy.command 或 01-Install-CodeBuddy.command。需要撤销时运行同一目录里的 02-Restore-*.command。遇到系统拦截时先核对下载来源，不要关闭系统整体安全保护。

安装脚本和 models.json 含你的 API Key，不要发到群聊、公开网盘或代码仓库。安装脚本负责配置，不会替你安装或登录客户端。

4. 手动添加模型

在客户端的模型设置中添加 OpenAI 兼容的自定义模型。不同版本的字段名称可能不同，按下表匹配。

字段填写内容
Base URL / 基础地址https://api.aiclub.quest/v1
要求完整接口地址时https://api.aiclub.quest/v1/chat/completions
API Key“生成配置”结果中的 apiKey，格式为 sk-...
Model ID / 模型名称请求 ID 使用 AICLUB 目录中的模型 ID；显示名称使用 AICLUB 前缀。

也可把生成的 models.json 放到所选客户端的目录。覆盖已有配置前请备份。

  • Windows WorkBuddy：%USERPROFILE%\.workbuddy\models.json
  • Windows CodeBuddy：%USERPROFILE%\.codebuddy\models.json
  • macOS WorkBuddy：~/.workbuddy/models.json
  • macOS CodeBuddy：~/.codebuddy/models.json

5. 同一把 API Key，切换模型

WorkBuddy 下拉框里的 AICLUB 只是本地显示前缀，实际请求仍使用 AICLUB 目录中的模型 ID。

  • AICLUB GLM 5.3 Flash → glm-5.3-flash
  • AICLUB Qwen 3.8 Flash → qwen3.8-flash
  • AICLUB MiniMax M3 → MiniMax-M3
  • AICLUB Kimi K2.7 Code → kimi-k2.7-code
  • AICLUB DeepSeek V4.1 Flash → deepseek-v4.1-flash
  • AICLUB Auto Flash → AHC-Auto-Flash
  • AICLUB Auto Quality → AHC-Auto-Quality

选择 Auto 服务时，AICLUB 会在可重试故障时按服务规则切换候选模型；单个直接模型不可用时，也可以选择其他入口，不需要重新购买 API Key。

先验证普通文字对话。图片、工具调用和其他高级能力以配置中开放的能力为准。

6. 查询与充值，原账户不变

在积分查询输入原 API Key，可查看余额、有效期、最近用量和官网支付记录。淘宝订单仍在淘宝查询。

淘宝充值

  1. 购买新的套餐 API Key，但不要把它启用为新账户。
  2. 打开积分充值，上方填原账户 API Key，下方填本次买到的新 API Key。
  3. 确认充值后核对余额和到期时间。继续使用原配置。

官网支付宝充值

仅在页面显示扫码入口时可用：输入原账户 API Key，选择套餐，创建订单并扫码。付款后留在原页面等待到账；记录订单号。未更新时先查支付记录或联系客服，不要重复支付。

账户到期后可充值续期。已冻结账户需先由客服核验；充值不会自动解除冻结。

7. 账户安全与售后

API Key 或配置泄露时，打开冻结页面，先查询，再确认冻结。冻结会停止后续使用，余额和历史记录保留；恢复需联系客服核验。

退款按原购买平台规则处理。已发出的 API Key 不会重新销售；退款确认后，未启用 Key 会作废，已启用账户会按售后核验结果冻结。不要因退款自行把 Key 转给其他人。

8. 常见问题

提示“已经启用”

到积分查询输入原 API Key 确认余额。已启用账户不需要再次启用；后续加积分请走充值页。

提示“凭证无效 / 401”

核对地址、完整 API Key 和多余空格；回到生成配置页重新生成。不要把订单号或其他平台 Key 填到 API Key。

提示“已到期 / 已冻结 / 403”

先查账户状态。到期可续费；冻结需联系客服，不要重新付款尝试解除。

提示“积分不足 / 402”

查询可用余额后充值，或减少本次请求的输出上限。

提示“服务暂时不可用 / 502 / 503”

选择 AICLUB Auto 服务或其他模型入口。失败请求的预留积分会释放；有疑问时保留请求编号，联系客服核对。

付款成功但积分没变

保留商户订单号、付款记录和 API Key 后四位，联系客服查单。不要提供支付密码，不要重复付款。