WorkBuddy

WorkBuddy 适合轻量办公和代码辅助场景。若支持自定义 Provider，可直接接入 FreeDom API。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

一、适用场景

• 想把 WorkBuddy 的模型请求接到 FreeDom API
• 已经有平台 API Key
• 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备

安装 WorkBuddy，并找到 AI Provider / Model Provider 设置。

三、配置接入

填写：

• Provider：Custom / OpenAI Compatible
• Base URL：https://api.yonghu.shop
• API Key：你的平台 Key
• Model：平台开放模型名

如果有 Headers 设置，确认 Authorization 形如：

Bearer 你的_API_Key

四、启动验证

发送一条日常办公类任务，例如“总结下面这段文字”。

五、推荐模型填写方式

优先使用控制台里真实展示的模型名。常见可尝试：

• Claude：claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
• Gemini：gemini-2.5-pro、gemini-2.5-flash
• OpenAI 兼容工具：按平台模型广场/控制台展示为准

六、常见问题

401 Unauthorized

API Key 错误、没保存成功，或请求头没有带上密钥。

403 Forbidden

通常是余额不足、Key 没有权限、模型未开放，或服务返回拒绝。

404 Model Not Found

模型名写错，或者当前 Key 没有这个模型权限。

429 Too Many Requests

请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。

七、实用建议

办公类工具建议用低成本模型作为默认，高阶模型只在复杂写作或代码任务中使用。

配置前检查

配置客户端前，先确认平台在线：

curl https://api.yonghu.shop/api/status

看到 success: true 或 HTTP 200，说明平台主入口正常。

如果客户端配置失败，优先按这个顺序排查：

1. API Key 是否复制完整，没有多余空格。
2. Base URL 是否该带 /v1。
3. 模型名是否与平台模型广场完全一致。
4. 当前 API Key 是否有该模型权限。
5. 余额是否充足。

成功后建议到 FreeDom API 控制台查看日志，确认请求确实打到了平台。

WorkBuddy 成功判据

WorkBuddy 若提供自定义 API 配置，按 OpenAI Compatible 方式接入：

Base URL: https://api.yonghu.shop
API Key: 你的 FreeDom API Key
Model: 平台模型名

如果工具区分 Chat / Completion / Responses，请优先选择 Chat Completions。