开始
四步完成使用
- 在销售平台购买对应积分套餐，等待兑换码发放。
- 在“购买”页激活兑换码，保存只显示一次的客户服务凭证。
- 在“生成配置”页验证凭证，下载专属
models.json或一键安装包并导入客户端。 - 开始使用；需要查看余额、续费或暂停时，使用服务中心对应标签。
一、购买和兑换码发放
正式销售接入后，请在闲鱼、淘宝或拼多多购买对应积分套餐，并以实际付款的平台订单为准。平台确认付款后会发放兑换码和本说明文档地址。当前测试环境的兑换码由测试负责人一对一发放。
- 没有收到兑换码：先检查平台订单是否已经显示“支付成功”。
- 不要重复提交同一个订单号或重复付款；遇到问题先联系客服。
- 收到兑换码后，不要把完整兑换码公开发到群聊或评论区。
服务中心负责兑换码激活和账户使用，不在这里输入支付密码，也不会要求你提供其他平台的登录凭证。
二、激活兑换码
- 打开服务中心的“购买”页。
- 把自动发货收到的兑换码粘贴到“我已有兑换码”。
- 点击“立即激活”。
- 激活成功后，立刻复制并保存客户服务凭证。它只会在激活成功时完整显示一次。
兑换码只能使用一次。激活后不要再次点击，重复激活会提示“兑换码已经使用”。
三、生成配置文件
- 打开“生成配置”页，先查看模型清单和默认接口地址预览。
- 输入激活时保存的客户服务凭证。
- 点击“生成配置”，确认专属 JSON 预览中的地址和模型。
- 按自己的系统选择复制 JSON、下载
models.json、Windows 一键导入文件或 macOS 安装包。
下载后先核对文件名为 models.json，再导入对应客户端。测试站的模型目录只验证配置流程，不代表真实模型可调用；正式站配置成功的验收标准是：客户端能看到已验证模型、普通文本请求能返回结果、积分查询能看到余额变化。
四、Windows 配置
在“生成配置”页验证客户凭证后，可以下载专属 models.json 或 APIHub-Credits-一键导入配置-Windows.bat。完全退出 WorkBuddy 或 CodeBuddy，备份原文件后，再运行脚本或手动放置配置。
- WorkBuddy：
%USERPROFILE%\.workbuddy\models.json。 - CodeBuddy：
%USERPROFILE%\.codebuddy\models.json。 - 一键导入文件会先备份已有
models.json，再把同一份客户配置写入两个目录；不存在的目录会自动创建。 - 配置完成后先进行普通文本测试，不要一开始就发送超长任务。
五、macOS 配置
在“生成配置”页可以下载专属 models.json 或 APIHub-Credits-安装-macOS.zip。完全退出客户端后，解压 ZIP，右键 APIHub-Credits-Installer.command 并选择“打开”。
- WorkBuddy：
~/.workbuddy/models.json。 - CodeBuddy：
~/.codebuddy/models.json。 - 安装器会先备份已有
models.json，再写入当前客户配置。 - 重新打开客户端后，从模型列表中选择 APIHub 模型进行文本测试。
安装包只包含当前客户配置；不要把配置文件或安装包上传到公开网盘、仓库或群聊。
六、查询余额和充值续期
在“积分查询”页可以查询兑换码状态，也可以用客户服务凭证查询当前余额、累计使用量和到期时间。
需要续费时：
- 购买新的积分套餐并等待新的兑换码。
- 打开“积分充值”页。
- 输入原客户服务凭证和新兑换码。
- 点击“充值续期”。积分会累加到原账户，有效期会按规则顺延。
七、冻结服务
如果怀疑客户服务凭证泄露，打开“冻结”页粘贴凭证，先点击“查询凭证”。页面会显示凭证状态、总额度、已使用、剩余和到期时间；确认选中无误后再点击冻结。冻结后模型调用会停止；需要恢复时联系客服，由管理员解冻。
冻结不是删除数据，也不会自动退款。具体售后规则以购买页面公示为准。
常见问题
在哪里购买？
在你下单的闲鱼、淘宝或拼多多商品页购买。服务中心的“购买”标签用于激活收到的兑换码，不会重复收款。
配置后没有模型怎么办？
确认客户端已经完全退出并重新打开；确认接口地址和模型来自最新生成的 models.json；再到“积分查询”确认账户没有到期或被冻结。
提示积分不足怎么办？
到“积分查询”查看余额，购买新套餐后到“积分充值”把新兑换码充入原账户。
兑换码提示不存在怎么办？
检查有没有复制多余空格、换行或标点；确认使用的是本服务最新发放的兑换码。仍有问题时保留订单号和错误提示，联系客服，不要公开发送完整凭证。
能不能把客户服务凭证发给客服？
除非客服明确要求并有安全渠道，否则不要发送完整凭证。优先提供订单号、兑换码后四位和错误截图。