1. 限流规则
为了保障平台的稳定性和所有用户的服务质量,FacePick API 采用请求频率限制机制。本文介绍限流规则、错误提示及应对方法。不同应用类型的默认请求频率限制(每分钟):
| 应用类型 | 请求限制(次/分钟) | 并发限制 | 说明 |
|---|---|---|---|
| 测试应用 | 60 | 5 | 适用于开发测试阶段 |
| 正式应用(基础版) | 300 | 10 | 适用于中小规模业务 |
| 正式应用(专业版) | 1,000 | 30 | 需申请开通 |
| 正式应用(企业版) | 5,000 | 100 | 需商务沟通定制 |
上表数值(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. 优化建议
- 合理控制请求频率,避免短时间内大量并发请求。
- 使用缓存机制,减少重复请求。
- 对于批量任务,建议使用异步方式或分批处理。
- 如需提升请求配额,请联系商务或提交下方演示工单(申请入口只进入本地演示工单,不改变真实权限、不自动扩容)。
真实站内工单
登录后创建并查看自己的工单,管理员处理结果保存到同一数据库并通过站内消息通知。不发送外部邮件、不接收附件,也不承诺回复时限。
进入我的站内工单这篇文章对你有帮助吗?