302API
实用教程 / 04 · WorkBuddy

WorkBuddy 接入 302API:完成一次基础文本对话

验证日期:2026-09-29。macOS 桌面版 WorkBuddy 5.6.2,模型 gpt-5.6-luna。已完成真实短对话并核对本站调用记录;本文验证范围为基础文本,不包含工具调用、图片、长上下文、多轮任务或其他模型。

想先在桌面客户端体验 302API,可以从一个新任务和一句简短提示开始。先把连接跑通,再按需要扩展任务规模。

1. 准备连接信息

配置项 填写内容
API 类型 OpenAI 兼容
Base URL https://api.302api.com/v1
模型 ID gpt-5.6-luna
API Key 在 302API 控制台 创建的 Key

建议使用单独的限额 Key,便于核对本次接入的费用。Key 只填入客户端的密钥输入框,不放进提示词、截图或公开文章。模型 ID 应完整填写,GPT-5.6 Luna 与 GPT-6 Luna 不能混用。

2. 在设置中配置模型

  1. 打开 WorkBuddy 的设置,进入“模型”,使用自定义模型入口。
  2. 选择 OpenAI 兼容类型,填写上表中的地址、模型 ID 和 Key。Base URL 填到 /v1,无需补上 /chat/completions。
  3. 首次验证时关闭模型工具支持,把最大输出 Token 设为 32。这只是短回复验证配置,后续正常使用可按任务需要调整。
  4. 保存配置,回到新建任务页面,明确选择 gpt-5.6-luna。

已有相同模型 ID 时先保留原配置。 本次版本中保存同名模型会更新现有配置;不要为了测试覆盖正在使用的 Key。正在运行的任务先保持原状,另建任务验证。

3. 发送一条短消息

在新任务中输入:

Reply only OK

本次实测收到 OK,桌面界面显示“已完成”,本站对应调用记录为成功。

“测试连接”只能作为初步检查:本次版本收到首个有效响应片段后就会主动取消检测。因此,还需要实际发送消息,等待完整回复与完成状态,再查看控制台记录。

4. 看清实际调用与费用

打开控制台调用记录,按模型、测试时间和专用 Key 核对状态与用量。客户端可能附带发起检测、标题等请求,一次点击发送不保证只有一笔调用。

本次 WorkBuddy 桌面对话发送一次消息,账本出现两笔成功记录;附加请求的具体用途没有独立追踪。费用请以本站实际调用明细为准,不依赖余额两位小数的变化判断是否收费。

5. 接入异常时怎么排查

  • 401 或认证失败: 检查 Key 是否有效、是否禁用,以及复制时是否多了空格。不要把完整 Key 发到聊天或工单里。
  • 模型不可用: 对照控制台确认完整模型 ID、权限和当前可用状态。
  • 看到文字但任务没完成: 先查调用记录;结果未知时不要连续点击重发。
  • 回复被截断: 短测试的 32 Token 上限可能不够实际任务使用,结合结束原因调整。
  • 发送按钮不可用: 重新进入一个新任务并正常键盘输入,确认客户端识别了编辑内容。

如需继续排查,可提供时间、模型 ID、本站请求编号和脱敏后的错误提示。更多说明见 流式输出与常见错误排查。

完成临时验证后,可停用测试 Key。若希望长期使用,配置适当限额并按实际用量观察成本。