外观
常见问题与故障排查
注册后为什么额度为 0？
DeepFlow API 当前采用管理员审核并分配额度的方式。密码注册已开放，但自动支付和注册赠送额度暂未开放。
[待补充：客服入口、额度申请格式和处理时间。]
API 地址是什么？
OpenAI 兼容 Base URL：
text
https://deepflow.online/v1完整 Chat Completions 地址：
text
https://deepflow.online/v1/chat/completions支持哪些模型？
请查看 https://deepflow.online/pricing，或使用当前密钥请求：
bash
curl 'https://deepflow.online/v1/models' \
-H 'Authorization: Bearer sk-your-deepflow-key'文档中的模型名只是示例。模型广场与接口返回结果优先。
如何计费？
- 文本模型通常按输入和输出 Token 计费。
- GPT Image 系列当前在模型广场中按请求显示价格。
- 实际费用以模型广场、模型详情和使用日志为准。
- 客户端显示的预估费用可能与最终账单不同。
常见 HTTP 状态码
| 状态码 | 含义 | 优先检查 |
|---|---|---|
400 | 请求参数错误 | JSON、模型参数、消息格式、图片参数 |
401 | 鉴权失败 | API 密钥是否完整、是否已禁用、Header 格式 |
403 | 权限或分组不允许 | 密钥分组、模型限制、IP 限制 |
404 | 地址或模型不存在 | Base URL、接口路径、模型 ID |
413 | 请求体过大 | 图片、音频、文件大小 |
429 | 请求频率或额度受限 | 并发、速率限制、账号余额、上游限流 |
500 | 服务内部错误 | 保留请求时间和错误信息后重试一次 |
502 | 上游返回异常 | 更换可用模型或稍后重试 |
503 | 服务暂时不可用 | 渠道状态、维护公告、稍后重试 |
504 | 请求超时 | 降低上下文或输出长度、增加客户端超时 |
401：Invalid token / Unauthorized
确认请求头格式：
http
Authorization: Bearer sk-your-deepflow-key常见错误包括漏写 Bearer、多余引号、复制了已禁用密钥、把后台系统访问令牌当成模型 API 密钥。
404：模型不存在
- 请求
/v1/models。 - 从返回结果复制模型 ID。
- 检查密钥分组是否允许该模型。
- 检查客户端是否擅自改写模型名或添加前缀。
429：请求过多或额度不足
- 降低并发并使用指数退避。
- 检查控制台余额和密钥额度。
- 不要用高频健康检查持续消耗配额。
- 若错误持续，记录时间、模型、请求 ID 和错误正文后联系支持。
流式响应中断
- 确认客户端支持 SSE。
- 增加读取超时，不只增加连接超时。
- 检查反向代理或企业网络是否缓冲长连接。
- 用
curl -N复现，区分客户端问题与服务问题。
提交问题时请提供
- 发生时间和时区。
- 请求接口和模型名。
- HTTP 状态码与完整错误正文。
- 请求是否流式。
- DeepFlow 密钥仅保留前 4 位和后 4 位，绝不发送完整密钥。
- 可复现的最小请求，删除业务数据和个人信息。
客服方式：[待补充：在线客服、邮箱、企业微信或工单地址。]