DOCS · v1

一个 sk- key,
覆盖所有主流模型。

DeepFlow 是 OpenAI 兼容的 API 中转网关,把请求路由到 OpenAI、Anthropic 和 Google 的最新模型。 改一个字符串就能在 gpt-5.5claude-opus-4-7gemini-2.5-flash 之间切换。

12+ 个模型 3 家厂商 4 套协议(Chat / Responses / Messages / Images) 无月费 · 按 token 计费

加入交流群

遇到问题?直接进群问 · 模型更新 / 分组扩容 / 故障公告第一时间在群里同步

QQ 群
QQ 群二维码 · 群号 1103388548
群号 1103388548 · QQ 扫码或搜索群号
微信群
微信群二维码 · deepflow_ai 交流 2 群
deepflow_ai 交流 2 群 · ⚠ 7 天有效,过期联系群主更新

01 快速开始

三步搞定:拿 key → 配 base_url → 发请求。

1. 拿一个 sk- key

登录 DeepFlow 控制台,在「API 密钥」里点「+ 新建密钥」,选择对应分组(Codex 混合 / Codex++ / Claude++ 等),复制生成的 sk-...

2. 配置 base_url

所有请求统一打到:

base_url
https://deepflow.online/v1

3. 发第一个请求

bash
# OpenAI Chat Completions · 流式
curl https://deepflow.online/v1/chat/completions \
  -H "Authorization: Bearer $DEEPFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"你好"}],
    "stream": true
  }'
i
国内用户直连即可,无需代理。延迟跟使用区域有关,韩国 SK 节点在国内大部分地区 100~300 ms。

02 认证

所有请求需要在 Header 中带 sk- key。

支持三种 Header 名(优先级从高到低):

  • Authorization: Bearer sk-... — OpenAI / Anthropic 标准
  • x-api-key: sk-... — Anthropic 兼容
  • x-goog-api-key: sk-... — Google 兼容
!
不要在前端代码里硬编码 key。 所有 sk- key 等同于钱,建议放到环境变量或服务端 proxy。一旦泄露立刻去控制台重置(老 key 立即失效)。

03 模型清单

基础价等同 OpenAI / Anthropic 官方,实际计费按账户分组倍率扣减。

Model厂商 输入 $/MTok输出 $/MTok 能力
gpt-5.5 OpenAI $1.25 $10 通用 · 流式 · 工具 · 视觉
gpt-5.5-pro OpenAI $15 $120 深度推理 · reasoning items
gpt-4o OpenAI $2.5 $10 通用 · 视觉
gpt-4o-mini OpenAI $0.15 $0.6 轻量 · 高吞吐
gpt-5.4 OpenAI $2 $8 通用
gpt-5.4-mini OpenAI $0.4 $1.6 轻量
gpt-5.3-codex OpenAI $1.5 $6 代码生成
claude-opus-4-7 Anthropic$15 $75 旗舰 · thinking
claude-sonnet-4-6 Anthropic$3 $15 通用
claude-haiku-4-5 Anthropic$0.8 $4 轻量
gemini-2.5-flash Google $0.075$0.3 超轻量 · 高吞吐
gpt-image-2 OpenAI 文生图 · 按图计费

实时清单:GET /v1/models 返回当前 sk- key 分组下可用模型。

04 API 端点

完整 OpenAI 兼容,同时原生支持 Anthropic Messages 协议。

POST
/v1/chat/completions OpenAI 风格对话补全 · 流式 · 工具调用 · 视觉 · 是最常用的端点
POST
/v1/responses Codex 新协议 · GPT-5 系列原生 reasoning items · 多轮对话保持状态
POST
/v1/messages Anthropic Messages 协议 · Claude 全家桶 · thinking · prompt cache
POST
/v1/images/generations 文生图 · gpt-image-2 / image-1.5 / image-1 · 默认 1024×1024
GET
/v1/models 实时模型清单 · 按 sk- key 所在分组返回可用模型

05 分组与倍率

不同分组承载不同上游账号,倍率影响最终扣费金额。

分组平台倍率包含模型说明
Codex 混合 OpenAI ×1.5gpt-5.5 / gpt-5.4 系列最划算 · 主流量入口
Codex++ OpenAI ×2.5GPT 全家桶 + image-2含 5.5-pro / image-2
Codex-车主定制OpenAI ×2.5同 ++ · 仅自家上游VIP 稳定性优先
Claude 混合 Anthropic×1.5haiku / sonnet / opus-4-6不含 4-7 / thinking
Claude++ Anthropic×2.5全 Claude · 含 opus-4-7 + thinking最强组合
日卡 100 / 200OpenAI ×1.0同 Codex 混合引流款 · 24h 限额
计费公式: 实扣额度 = 输入 token × 输入单价 × 倍率 + 输出 token × 输出单价 × 倍率,从你的额度卡 / 日卡余额扣减。

06 定价 · 套餐

¥3.99 起,无月费,量大递阶。

套餐额度有效期单价 ¥说明
GPT 日卡 · 入门 $100 24 小时¥3.99 轻量试用 · 当日有效
GPT 日卡 · 标准 $200 24 小时¥6.99 推荐尝鲜
GPT 额度卡 · 标准 ★$200 365 天¥12.9 性价比首选
GPT 额度卡 · 进阶 $500 365 天¥29.9 中量长期
GPT 额度卡 · 专业 $1000 365 天¥58.8 大量长期
GPT 企业卡 CUSTOM定制 SLA / 专属分组 · 联系商务

购买入口:pay.ldxp.cn/shop/4G058ZE4 →

07 客户端集成

所有 OpenAI 兼容客户端开箱即用。

Cursor
Settings → Models → Override OpenAI Base URL → 填 https://deepflow.online/v1,API Key 填 sk-。
Continue.dev
config.json"apiBase":"https://deepflow.online/v1""apiKey",模型用 gpt-5.5
Cherry Studio
设置 → Provider → 添加 OpenAI 兼容,Endpoint https://deepflow.online,API Key 填 sk-。
Claude Code
环境变量 ANTHROPIC_BASE_URL=https://deepflow.online + ANTHROPIC_AUTH_TOKEN=sk-...
Codex CLI
~/.codex/auth.jsonOPENAI_API_BASEOPENAI_API_KEY,可走 /v1/responses
OpenAI SDK
Python / Node 官方 SDK 直接传 base_url + api_key 即可,不需改任何代码。

08 SDK 接入示例

Anthropic Messages 协议示例(Claude 系列推荐)。

Python (anthropic SDK)

python
# pip install anthropic
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-...",
    base_url="https://deepflow.online",  # 注意没 /v1
)
msg = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[{"role":"user","content":"你好"}],
)
print(msg.content[0].text)

流式响应(SSE)

python
with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=2048,
    messages=[{"role":"user","content":"讲个故事"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

09 错误码

遇到问题先看 HTTP 状态码 + 响应 body。

状态含义常见原因处理
401认证失败key 错 / 已重置 / 已过期检查 Authorization header
403权限不足key 不在请求模型的分组里切到对应 key 或加分组
404模型不存在model 名错 / 当前分组无此模型/v1/models
429限流RPM/TPM 超限 · 上游账号被限退避重试 / 升档
503无可用账号所有上游号都限流 · channel restriction等待 5 min 自动恢复
5xx网关错误上游不稳定 · 网络抖动指数退避重试
!
503 立返(< 300ms)很可能是「key 没权限」而非真限流。检查你的 key 是否在该 model 所属分组(Codex++ 才能调 5.5-pro / image-2)。

10 故障排查

常见现象与对应排查路径。

客户端报「连接超时」

  • 确认 base_url 拼写正确(https://,不是 http://)
  • 检查本地代理:本服务在国内可直连,不需要走 VPN
  • curl -I https://deepflow.online 验证连通性

响应一直没数据 / 流式卡死

  • 客户端未正确处理 SSE,检查 stream: true 设置
  • 上游账号 token 失效会导致首字延迟变长,重试一般会切到健康号
  • 5.5-pro 推理模型首字本身就慢(2-5s 正常)

额度扣减异常

  • 计费按真实 token 数,跟客户端显示的字符数不是 1:1
  • 分组倍率会乘上去,Codex++ ×2.5 比 Codex 混合 ×1.5 贵 67%
  • 详细明细在 控制台 → 用量明细 查看

11 服务状态

实时探活 · 历史可用率 · 故障复盘。

渠道状态实时面板:控制台 → 渠道状态 显示 5 个销售分组的对话延迟、端点 PING、7 天可用性、近 60 次记录条形图。

告警通过 Bark 推送,4 小时去重,触发条件:剩余天数 < 3 / 关键 endpoint 连续 180s 失败 / fail_count ≥ 3。

12 常见问题

每月被问最多的几条。

和 OpenAI 官方有什么区别?
国内直连,不用代理。一个 sk- key 透明覆盖 OpenAI / Anthropic / Google 三家;无月费,按真实 token 计费,跟官方价同步;额外提供 Codex 混合 / Codex++ / Claude 混合等分组,可按需选择倍率。
能在 Cursor / Continue / Cherry Studio 用吗?
完全兼容 OpenAI 协议。在 Cursor / Continue / Cherry Studio / OpenAI SDK 等客户端,把 base_url 设为 https://deepflow.online/v1,填入 sk- key,模型名直接用 gpt-5.5 / claude-opus-4-7 / gemini-2.5-flash 即可。
额度怎么计费?
默认按真实 token 计费(基础价见模型清单)。也可购买日卡 / 额度卡套餐,在有效期内按倍率扣减。Codex 混合 ×1.2,Codex++ ×2.0,Claude 混合 ×1.2;详细规则见控制台。
服务稳定吗?
自有账号池 + 多家厂商分流,单账号失效自动切换(RTO < 1 秒)。Caddy 自动 HTTPS、IP 白名单、JWT 鉴权、审计日志、Bark 告警推送都标配。
忘记 key 怎么办?
进控制台「我的账户 → API 密钥」可以查看 / 重置 / 新建 sk- key。重置会让旧 key 立即失效,请提前更新到调用方。
遇到 503 怎么办?
先看响应延迟。立返 < 300ms 通常是 channel restriction(你的 key 不在该 model 分组),检查 /v1/models 列表;等几秒后才返是真限流,等 5 分钟或换分组重试。