在 OpenAI 兼容客户端中使用 ZhiFlo

如果你的客户端不在本帮助中心列表里，但支持自定义 OpenAI 服务，就走这条通用路径。目标不是只把字段填进去，而是让该客户端真的回一条 OK。

1. 字段对照

客户端字段	填写内容	含义
Provider type / API type	OpenAI 或 OpenAI-compatible	让客户端使用兼容请求格式
Base URL / API URL	https://api.zhiflo.com/v1	请求发送到的服务地址
API Key / Token	当前设备专用的 ZhiFlo Token	连接 API 的密码
Model / Model ID	账户列表中的完整模型 ID	API 实际识别的模型

如果客户端同时要求“显示名称”，可以填写 ZhiFlo；显示名称不会替代模型 ID。

2. 填写并启用

1. 在客户端设置中找到 Provider、Model service 或 API 页面。

2. 添加一个自定义提供方。

3. 选择 OpenAI-compatible 类型。

4. 填写上表中的 Base URL。

5. 把 Token 粘贴到专用 API Key 或 Token 字段。

   不要把 Token 放进 Base URL、服务商名称、模型名称或截图。

6. 添加账户当前显示的完整模型 ID。

7. 保存提供方。

8. 启用该提供方。

9. 把刚添加的模型设为当前模型。

10. 如果客户端明确支持配置热更新，重新载入模型列表；否则完全退出并重新打开客户端。

保存后仍需启用和选择当前模型。只看到提供方名称，不表示请求已经使用它。

3. Base URL 还是完整请求 URL

大多数客户端要求 Base URL，此时填写：

https://api.zhiflo.com/v1

只有字段明确要求完整 Chat Completions endpoint 时，才填写：

https://api.zhiflo.com/v1/chat/completions

不要把完整端点填进 Base URL 字段，否则客户端可能再次追加 /chat/completions 并得到 404。

4. 发送一次最小消息

在客户端中选择 ZhiFlo 模型并发送：

只回答 OK。

收到 OK 才算这条通用配置成功。仅通过 API Key 检查、看到绿色状态或看到模型名称，都不能替代这一步。

如果失败，先按顺序检查：字段类型、Token 状态、模型 ID、Base URL、额度、网络。具体症状见 连接故障排查。

下一步：需要编写请求时，查看 第一次 API 请求。