Skip to content

速率限制说明 ​

概述 ​

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

限流维度 ​

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

常见限制 ​

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

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

错误表现 ​

json
{
  "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 秒