DeepChat 接入
难度 🧩 中等 | 接口格式 OpenAI 兼容 | base_url
https://byesu.com/v1
DeepChat 是一款开源、跨平台的全功能 AI 客户端（Windows / macOS / Linux 桌面应用），支持接入云端与本地模型，自带多会话、智能体、工具调用等能力。把它的「服务商」指向半页酥 API，就能在本地客户端里直接调用 gpt-5.5、claude-opus-4-8、gemini-3.1-pro-high 等模型。
第 1 步：下载安装 DeepChat
前往 DeepChat 官网或 GitHub Releases，下载对应系统的安装包（Windows .exe / macOS .dmg / Linux .AppImage），安装并打开。
第 2 步：添加半页酥服务商
打开 DeepChat，点击左下角 设置（齿轮图标）→ 模型服务，新增一个服务商。
选择正确的提供商类型
半页酥 API 走 OpenAI 兼容接口，新增服务商时请选择「OpenAI」或「OpenAI 兼容」类型，不要选成 Anthropic / Claude 官方类型，否则地址与鉴权格式不匹配。
填写以下字段：
| 字段 | 填写内容 |
|---|---|
| 名称 | 半页酥 API（自定义，方便识别） |
| API 地址 / API Host | https://byesu.com/v1 |
| API Key | 你在控制台创建的令牌，形如 sk-xxxx |
保存后开启该服务商的开关。
关于 API 地址
DeepChat 通常会自动在地址后补全 /chat/completions 等路径。如果连接失败提示 404，请尝试只填到 https://byesu.com/v1（不要自己再加 /chat/completions）；若仍不通，可改填 https://byesu.com，让客户端自动拼接 /v1。
第 3 步：添加并启用模型
在该服务商下进入模型列表，点击「添加模型」或「获取模型列表」，手动填入要使用的模型名并启用。常用模型：
gpt-5.5
claude-opus-4-8gemini-3.1-pro-high模型名必须与半页酥 API 实际可用的模型一致，且要在你令牌所属分组的可用范围内。
第 4 步：跑起来验证
返回主界面，在顶部模型选择器里选中刚才添加的服务商与模型（如 claude-opus-4-8），新建一个会话，发送一句「你好」。
能正常收到回复，就说明接入成功了。
卡住了？
- 401 / 鉴权失败：API Key 填错或带了多余空格，请重新从控制台复制完整的
sk-xxxx。详见 常见错误 #auth。 - 404 / 接口找不到：API 地址里手动多加了
/chat/completions，删掉后路径只保留到/v1，或改填https://byesu.com让客户端自动拼接。 - 无可用渠道 / 模型不存在：模型名拼写有误，或当前令牌所属分组不包含该模型。请核对模型名并 选择分组，详见 常见错误 #no-channel。
- 额度不足 / 余额为 0：账户或令牌额度用尽，请充值或调整令牌额度。详见 常见错误 #balance。