DeepFlow API 文档

外观

平台介绍与快速开始 ​

DeepFlow API 提供统一的 AI API 网关。用户只需使用一个 DeepFlow API 密钥和统一地址，即可调用账号所属分组中已开放的模型。

DeepFlow API 首页

重要地址 ​

用途地址
官网https://deepflow.online
注册https://deepflow.online/register
登录https://deepflow.online/login
控制台https://deepflow.online/dashboard
模型广场https://deepflow.online/pricing
OpenAI 兼容 Base URLhttps://deepflow.online/v1
Chat Completionshttps://deepflow.online/v1/chat/completions
Responseshttps://deepflow.online/v1/responses
图像生成https://deepflow.online/v1/images/generations

客户端要求填写“API 地址”时，优先使用 https://deepflow.online/v1。只有明确要求完整接口地址时，才填写 /v1/chat/completions 等完整路径。

1. 注册与额度 ​

  1. 打开 https://deepflow.online/register 创建账号。
  2. 登录后进入控制台。
  3. 新注册账号的初始额度为 0，需要等待管理员审核并分配额度。
  4. 当前未开放自动充值；额度申请方式见后续客服公告。

[待补图：DeepFlow 注册页。当前浏览器已有登录状态，无法取得无账号信息的注册截图。]

2. 创建 API 密钥 ​

进入控制台左侧的 API 密钥，点击 创建 API 密钥。

创建 API 密钥

建议设置：

  • 名称：按用途命名，例如 cherry-studio、production-app。
  • 分组：选择需要使用的模型分组；不确定时使用管理员建议的默认分组。
  • 过期时间：生产密钥建议设置明确的有效期。
  • 额度：测试密钥设置独立额度，避免意外消耗全部余额。
  • 高级设置：生产环境可限制模型和来源 IP。

创建后立即妥善保存密钥。示例统一写作：

text
sk-your-deepflow-key

不要把真实密钥提交到 Git、聊天记录、工单截图或前端代码中。

3. 选择模型 ​

打开模型广场，按分组、供应商、类型或标签筛选模型。模型名必须与页面显示完全一致。

DeepFlow API 模型广场

也可以通过接口读取当前密钥实际可用的模型：

bash
curl 'https://deepflow.online/v1/models' \
  -H 'Authorization: Bearer sk-your-deepflow-key'

模型广场展示的是站点公开配置；GET /v1/models 返回的是当前密钥和分组可调用的模型。两者不一致时，以接口返回结果为准。

4. 发出第一个请求 ​

下面使用当前已开放的 gpt-5.6-luna 演示。若模型广场中已不再显示该模型，请换成实际可用的模型 ID。

bash
curl 'https://deepflow.online/v1/chat/completions' \
  -H 'Authorization: Bearer sk-your-deepflow-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {"role": "user", "content": "用一句话介绍 DeepFlow API。"}
    ],
    "stream": false
  }'

成功时会返回 OpenAI Chat Completions 兼容 JSON，正文通常位于：

text
choices[0].message.content

5. 在线验证 ​

登录后打开游乐场，选择模型并发送一条简短消息。它适合验证账号额度、分组和模型是否可用。

DeepFlow API 游乐场

建议按下面顺序排查：

  1. 游乐场能否正常回复。
  2. GET /v1/models 是否能看到目标模型。
  3. 使用 cURL 发送最小请求。
  4. 最后再配置 Cherry Studio、ChatBox、Dify、Cursor 等第三方客户端。

6. 密钥安全 ​

  • 服务端通过环境变量保存密钥，例如 DEEPFLOW_API_KEY。
  • 不要在浏览器前端直接调用需要密钥的接口。
  • 为不同应用创建不同密钥，便于限额、撤销和审计。
  • 密钥疑似泄露时立即禁用并重新创建。
  • 日志中只显示前后少量字符，禁止记录完整 Authorization 请求头。

模型、分组和价格以 DeepFlow API 模型广场实时显示为准。

© 2026 DeepFlow API