速率限制说明

概述

心流对 API 调用实施速率限制，以保障服务稳定性。超过限制时返回 HTTP 429。

限流维度

维度	说明
RPM (Requests Per Minute)	每分钟请求次数
TPM (Tokens Per Minute)	每分钟 Token 消耗量（对话模型）
并发视频任务	同时进行的异步视频生成任务数

常见限制

分组	大致 RPM	说明
default	视 Key 配置而定	默认分组，联系客服确认具体数值
low	视 Key 配置而定	低价组，限制可能更严格
官转各组	视 Key 配置而定	原厂直连通道

⚠️ 具体限制数值取决于 Key 的配置，以管理后台显示的限额为准。本文档仅供一般性参考。

错误表现

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

处理建议

1. 指数退避重试：遇到 429 后等待 2s → 4s → 8s → 16s，最多重试 3 次
2. 降低并发：同时进行的请求数控制在 5 以内
3. 视频任务减速轮询：轮询间隔 ≥10 秒
4. 使用缓存：利用 cached_tokens 减少重复 Token 消耗
5. 联系客服：如需更高限额，联系客服提升 Key 的配额

视频特殊说明

视频任务提交后由异步队列处理，同时进行的视频任务数有上限。超出时返回 429。建议：

• 一次只提交 1~2 个视频任务
• 上一个任务进入 completed 或 failed 后再提交下一个
• 轮询间隔设为 10~15 秒