集成
Cherry Studio
在 Cherry Studio 中把 Half Off Dev 添加为 OpenAI 兼容供应商，以官方半价与 Claude、GPT 和 Gemini 对话。
Cherry Studio 是一款支持多家模型供应商的桌面聊天客户端，可在 Windows、macOS 和 Linux 上运行。把 Half Off Dev 添加为 OpenAI 兼容供应商后，一个密钥就能在里面使用 Claude、GPT 和 Gemini，每个模型都按官方价格的一半计费。开始前请先创建 API 密钥。
一键导入#
在 API 密钥页面依次选择 接入客户端 → Cherry Studio → 在 Cherry Studio 中打开，供应商会自动建好（需先安装 Cherry Studio）。刚创建的密钥会自动填入；旧密钥请把完整内容粘贴到对话框里，因为 Half Off Dev 只保存它的哈希。
手动配置#
新建一个供应商，填写：
| 字段 | 值 |
|---|---|
| 供应商类型 | OpenAI 兼容（或 “New API”） |
| API 地址 | https://halfoff.dev（不要加 /v1，应用会自动补上） |
| API 密钥 | 你的 ho-... 密钥 |
然后按 ID 添加模型，例如 claude-sonnet-5.5、gpt-6.1-sol 和 gemini-3.1-pro。其余模型见模型列表。
常见报错#
| 现象 | 处理方法 |
|---|---|
401 Invalid or revoked API key | 密钥输错、被截断或已吊销。重新粘贴，或新建一个。 |
404 Model '...' is not available | 模型 ID 不存在。从 GET /v1/models 或模型列表复制。 |
404 且路径里有 /v1/v1/ | API 地址末尾带了 /v1。改成 https://halfoff.dev。 |
404 Unknown endpoint | Cherry Studio 的某个功能调用了 Half Off Dev 不提供的 API，例如 embeddings。聊天用 Half Off Dev，该功能另选供应商。 |
402 | 余额已用完，或密钥达到消费上限。见余额与计费。 |
其他状态码见错误码。