客户端配置

通用参数

大多数支持 OpenAI 自定义服务的客户端只需要下面三项：

项目	填写内容
API Key	在 DeepFlow API 密钥 页面创建的 sk-... 密钥
API Base URL	https://deepflow.online/v1
Model	从模型广场或 GET /v1/models 复制准确模型 ID

常见地址差异：

• 要求“服务地址 / Host”：填写 https://deepflow.online。
• 要求“OpenAI Base URL”：填写 https://deepflow.online/v1。
• 要求“Chat Completions Endpoint”：填写 https://deepflow.online/v1/chat/completions。

不要在 Base URL 后重复添加 /v1。例如客户端自动拼接 /v1/chat/completions 时，应根据它的说明改填站点根地址。

Cherry Studio

1. 下载并打开 Cherry Studio：https://www.cherry-ai.com/。
2. 进入 设置 → 模型服务。
3. 新增 OpenAI 兼容服务商。
4. API 地址填写 https://deepflow.online/v1。
5. 填入 DeepFlow API 密钥。
6. 手动添加模型，或使用客户端的模型列表功能读取模型。
7. 在新对话中选择模型并发送测试消息。

[待补图：Cherry Studio 的服务商设置、添加模型、选择模型三个界面。]

ChatBox

1. 下载 ChatBox：https://github.com/Bin-Huang/chatbox/releases。
2. 在设置中选择 OpenAI API 或自定义 OpenAI 兼容服务。
3. API Host / Base URL 填写 https://deepflow.online/v1。
4. 填入 API 密钥和模型 ID。
5. 新建对话进行测试。

[待补图：ChatBox 自定义服务配置页。]

Cursor 与其他编程客户端

客户端版本不同，可用的自定义 OpenAI 配置入口也不同：

1. 找到 OpenAI API Key 或自定义 Provider 设置。
2. 启用自定义 Base URL 时填写 https://deepflow.online/v1。
3. 添加模型广场中当前可用的模型 ID。
4. 先使用简短请求测试，再开启代理、工具调用或长上下文任务。

不要自行给模型名添加前缀。模型 ID 必须以 DeepFlow 模型广场或 /v1/models 返回值为准。

[待补图：Cursor 当前版本的自定义 OpenAI 配置页。]

Dify

1. 进入 设置 → 模型供应商。
2. 选择 OpenAI-API-compatible 或自定义 OpenAI 兼容供应商。
3. Base URL 填写 https://deepflow.online/v1。
4. 填入 DeepFlow API 密钥。
5. 添加模型 ID，并按实际能力选择 Chat、Completion 或其他类型。
6. 在 Dify 中执行一次模型连通性测试。

[待补图：Dify 模型供应商配置页。]

N8N

可以使用 OpenAI 节点的自定义 Base URL，也可以通过 HTTP Request 节点直接调用：

POST https://deepflow.online/v1/chat/completions
Authorization: Bearer {{$env.DEEPFLOW_API_KEY}}
Content-Type: application/json

生产工作流中应把密钥放入 Credentials 或环境变量，不要直接写在节点正文中。

[待补图：N8N Credentials 与 HTTP Request 节点。]

环境变量示例

export OPENAI_API_KEY='sk-your-deepflow-key'
export OPENAI_BASE_URL='https://deepflow.online/v1'

部分 SDK 使用 OPENAI_BASE_URL，部分工具使用 OPENAI_API_BASE。以所用客户端的官方说明为准。

配置失败时

1. 确认地址没有重复 /v1/v1。
2. 确认没有把完整 /chat/completions 地址填入只需要 Base URL 的字段。
3. 确认模型 ID 大小写和符号完全一致。
4. 确认密钥所属分组可以访问该模型。
5. 先用 cURL 调通，再排查客户端自身设置。