免费API调用频率限制是多少

接入与开发

把免费API的频率限制拆成看得懂的几类规则,给出按限制调调用的做法和撞限流后的排查顺序。

刚拿到免费Key、跑通第一个请求之后,真正卡人的往往是第二次、第十次调用:有时报限流,有时不报错但明显变慢。多数人第一反应是猜自己额度用完了,实际是没搞清对方限的是哪一层。这篇把免费API常见的限制规则归成几类,给出按规则设计调用的步骤和一段撞限流后的排查顺序,末尾说明哪些情形下这套经验不适用。

刚拿到免费Key、跑通第一个请求之后,真正卡人的往往是第二次、第十次调用:有时直接报限流,有时不报错但明显变慢。多数人第一反应是猜自己额度用完了,实际常见情况是没搞清对方限的是哪一层。免费接口的限制通常不止一条,摸错层就会改错方向,白折腾半天。

这篇把免费API常见的限制归成几类,给出怎么查到自己这条Key的实际口径、怎么按规则设计调用,以及撞上限流后的排查顺序。最后说明哪些情形下这套经验不适用,别照搬到所有场景。

免费API到底在限什么:四层限制分清楚

免费接口的限制很少只有一条,通常分成几层叠在一起。频率类看的是单位时间内的请求数,和token用量无关;额度类看的是总量,用完了再慢也调不通;并发类看同时在跑的请求数,串行发请求再多也不会触发;速率类看每秒流量,流式和图片这类吃带宽或算力的接口常按这个限。还有一层是模型级限制,同一个Key下不同模型的可用量可能不同。

频率限制
单位时间内的请求条数,超出直接报限流,和单次请求多大无关
额度限制
一段时间内的总量,用完就调不通,降速也没用
并发限制
同时进行中的请求数,串行慢慢发不会踩线
速率限制
按每秒流量算,流式输出和图片生成更常见
模型级限制
同一Key下不同模型口径可能不同,一个模型报限流不代表账号被封

判断顺序很简单:先看报错文案指向的是请求数、总量还是并发,再去厂商文档核对口径,别一上来就换Key。换Key往往解决不了模型级或额度级的问题,只会让排查更难。

怎么查到自己这条Key的实际限制

厂商文档里一般有限流说明,但中转站往往再叠一层自己的规则,两头都要看。文档写得含糊时,最可靠的办法是自己小步测出来,而不是在网上抄别人贴的数字——那些数字会变,也未必对应你这条Key。

  1. 读两处说明先看厂商文档的限流段落,再看你所用中转站的说明页,确认是否有额外限制
  2. 从低频起步加压写个小脚本,从很低频开始逐档加请求,记下第一个报限流的档位,不要一次性打满
  3. 分模型分别测同一Key换几个模型各测一轮,确认限制是不是按模型分开算的
  4. 记成自己的表把接口路径、时间窗、频次上限、是否分模型记下来,后续写代码直接照这张表限速

查不到明确数字时,按最保守的假设写代码,留出余量比事后补救省事。要对照各家接口的口径,可以到 看模型资料,再到 核对中转站说明。

按限制设计调用:白嫖党也能跑稳的四步

知道限制在哪一层之后,代码要按限制来写,而不是等报错再改。核心思路是把请求摊开、把失败当常态处理、把进度存下来。下面这四步对个人脚本和小团队都适用。

  • 客户端先做限速:用令牌桶或固定间隔把请求摊开,别让循环体一口气发几百个
  • 重试要带退避和抖动,且只对限流类错误重试,参数错、鉴权错重试多少次都没用
  • 批处理拆成小批次,每批之间留间隔并记录游标,中途撞限流能接着跑而不是从头再来
  • 把请求数、报错类型、耗时记进日志,出问题时能看出是哪一层先顶不住
# 伪代码思路:固定间隔 + 指数退避
for item in batch:
  sleep(interval)          # 先把请求摊开
  resp = call_api(item)
  if is_rate_limited(resp):
    sleep(base * 2 ** n + jitter)
    retry(item)
  save_cursor(item)       # 进度落盘,断了能续

小团队尤其注意共用Key这件事:几个人各自在本地跑脚本,单看每人都不超频,加在一起就可能撞线。约定一个统一的限速入口,或者干脆给每人一个独立Key,比事后互相甩锅有效。

撞上频率限制了,按这个顺序排查

报限流时最忌乱改:一会儿换Key,一会儿改参数,最后不知道是哪一步起的作用。按下面的顺序一步步排除,每一步都能确认或排除掉一层原因。

  1. 先定性确认错误码与文案属于限流,而不是鉴权失败或参数写错,避免改错方向
  2. 对照自己的调用表看是不是瞬时超了时间窗,如果是,降速加退避一般就能恢复
  3. 查共用情况检查是否多进程、多设备共用同一个Key导致总量叠加,这是小团队最容易忽略的一条
  4. 核对现状以上都不成立,去站内看这家接口的限速与额度有没有调整,可以到 看变动记录
  5. 改长期方案给自己加一层排队与分批,不要每次出事手动重跑
现象更可能的原因先做什么
第一次调用就报限流额度用完或鉴权有问题核对额度与Key状态
跑几十次后突然报限流瞬时超出频率时间窗降速加退避
单跑正常、多人一起跑就报共用Key总量叠加拆分Key或统一限速
只有某个模型报限流模型级限制换模型或单独核对该模型口径
不报错但明显变慢速率或并发接近上限看耗时日志,降低并发

这套经验也有不适用的时候:一是厂商或中转站临时调整规则,你按旧表限速照样会撞线,这时只能重新测;二是接口本身有突发流量或共享配额,别人把池子用掉一部分,你的可用额度也会跟着缩水,个人侧怎么优化都有限;三是流式接口和图片接口的限制口径与普通文本请求不同,照抄文本接口的限速参数没意义。遇到这三类情形,去站内相关页面核对当时的说明,再调整自己的调用策略。

限流不是故障,是对方在告诉你规则在哪一层;搞清哪一层,再决定降速还是换路。
下一步想知道某家免费接口现在到底怎么限、中转站有没有额外限制,到站内汇总页对照看一遍,比在群里问一句更靠谱。

常见问题

免费API的频率限制一般是按分钟还是按天算?

两种都有,而且常常同时存在:短的看每分钟请求数,长的看每天或每月的总量,有的还单独限制并发。看文档时要把这几条一起抄下来,只记住一个数字很容易在实际调用时撞线。

报限流了换一个免费Key能解决吗?

短期可能有效,但不建议当作方案。很多平台按账号、手机号或支付方式判重,换Key只绕开一时;而且多Key轮换会让调用量更难统计,出问题更难定位。优先把请求摊开和控制并发。

免费额度和频率限制是一回事吗?

不是。额度是总量,用完就彻底不能用;频率是速率,没超额但发太快也会被拒。前者要算够不够用,后者要设计好节奏,混在一起看容易误判成额度已经耗尽。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。