桌面与 Web 客户端
不同客户端对「站点根 / Base URL / 完整 endpoint」的理解不一致。请按下表逐项填写，不要把同一串地址套用到所有软件。
地址与协议速查
| 客户端 | 填写地址 | 协议 / 类型 |
|---|---|---|
| Cherry Studio | https://app.helpday.work | OpenAI Responses |
| Open WebUI | https://app.helpday.work/v1 | OpenAI · 默认 Chat Completions |
| Cursor 等 OpenAI 兼容 | https://app.helpday.work/v1 | Chat Completions / Responses（视版本） |
| Claude Code | https://app.helpday.work | Anthropic Messages |
Cherry Studio
- 更新到当前版本，打开「模型服务」→「添加自定义提供商」。
- 名称填 Yoriday；API 地址填
https://app.helpday.work（站点根，不要/v1）。 - 粘贴为该客户端单独创建的 API Key。
- 手工添加控制台中的文字模型 ID。
- 在「更多端点」中启用 OpenAI Responses，做连接检测后发一条测试消息。
Cherry Studio 会自行拼接 Responses 路径，因此这里填站点根。若找不到「更多端点」，先升级客户端。
Open WebUI
- 管理员进入 Admin Settings → Connections → OpenAI。
- 新增连接，URL 填
https://app.helpday.work/v1，并写入 API Key。 - 首次只开文字 Chat Completions，图片 / 文件等能力先关掉。
- 模型列表未自动出现时，在 Model IDs 过滤中粘贴控制台模型名。
- 新建对话发送测试句，并到 Yoriday 控制台核对调用记录。
多用户实例应由管理员保管密钥。管理端口放在受信网络，并打开 Open WebUI 自身的登录与访问控制。
Cursor 等编辑器插件
- 选择 OpenAI Compatible / Custom 提供商。
- Base URL 一般填
https://app.helpday.work/v1。 - 模型名与控制台保持一致；改完后重启插件或窗口再测。
- 若插件支持 Responses，可在 Chat Completions 稳定后再切换对比。
Claude Code
完整步骤见 Claude Code（Messages）。要点：
ANTHROPIC_BASE_URL 使用 https://app.helpday.work，令牌使用控制台 Key。
验证与安全
- 每个客户端独立 Key，方便限额、审计与吊销。
- 测试句建议固定为「请回复：连接成功」，便于对照控制台。
- 遇到 404 时检查是否写成
/v1/v1、是否把完整 endpoint 误填进 Base URL。 - 文字通了再开流式与工具，问题更容易定位。
- 截图与工单里的密钥只保留末尾少量字符。