交互演示 · 非生产数据查看建设进度
FacePick 脸谱开放平台 · 开发者控制台

请求频率限制(Rate Limit)

更新时间:2025-08-20 · 浏览量:6,438(原型样例数据,不是真实统计)

1. 限流规则

为了保障平台的稳定性和所有用户的服务质量,FacePick API 采用请求频率限制机制。本文介绍限流规则、错误提示及应对方法。不同应用类型的默认请求频率限制(每分钟):

应用类型请求限制(次/分钟)并发限制说明
测试应用605适用于开发测试阶段
正式应用(基础版)30010适用于中小规模业务
正式应用(专业版)1,00030需申请开通
正式应用(企业版)5,000100需商务沟通定制
上表数值为原型示例,非当前生效配额:本工程未接入真实限流与配额服务。频率限制(每分钟次数)、并发限制(同时进行的请求数)与剩余额度(套餐可用总量)是三个不同概念。

上表数值(60/300/1,000/5,000 次每分钟及并发 5/10/30/100)为原型示例,非当前生效配额:本工程未接入真实限流与配额服务。频率限制(每分钟次数)、并发限制(同时进行的请求数)与剩余额度(套餐可用总量)是三个不同概念——429 与频率有关,套餐额度与总量有关,与 24-1「如何提升调用额度」相互区分并互链。

2. 响应示例(超出频率限制)

当请求超过限制时,API 会返回 429 Too Many Requests 错误:

{
  "code": 429,
  "message": "Too Many Requests",
  "request_id": "req_20250820_123456",
  "retry_after": 60,
  "timestamp": "2025-08-20T10:24:36Z"
}

示例中的 https://api.demo.invalid 与 fp_demo_not_valid_… 均为占位演示值;复制示例不会执行任何网络请求。

retry_after 表示建议的等待时间(秒),请在该时间后重试请求,并建议配合指数退避,避免重试风暴再次触发限流。

3. 优化建议

  • 合理控制请求频率,避免短时间内大量并发请求。
  • 使用缓存机制,减少重复请求。
  • 对于批量任务,建议使用异步方式或分批处理。
  • 如需提升请求配额,请联系商务或提交下方演示工单(申请入口只进入本地演示工单,不改变真实权限、不自动扩容)。

真实站内工单

登录后创建并查看自己的工单,管理员处理结果保存到同一数据库并通过站内消息通知。不发送外部邮件、不接收附件,也不承诺回复时限。

进入我的站内工单

这篇文章对你有帮助吗?

← 返回常见问题列表当前分类:API 使用(返回后保留你之前的筛选状态)