很多人看到某家中转站写着每天送免费额度,注册完兴冲冲配好 Key,结果第一次请求就报 401、429 或者干脆没响应。心里第一反应是「额度是假的吧」。其实大部分情况是配置没对上:额度挂在哪个分组、Key 有没有生效、模型名写的是不是站内那一版。这篇按从粗到细的顺序给你排一遍,照着做就行。
很多人看到某家中转站写着每天送免费额度,注册完兴冲冲配好 Key,结果第一次请求就报 401、429,或者干脆没响应。心里第一反应是「额度是假的吧」。先别急着下这个结论。大部分情况是配置没对上:额度挂在哪个分组、Key 有没有生效、模型名写的是不是站内那一版。
这篇按从粗到细的顺序给你排一遍,照着走就行。整个流程基本十分钟内能定位到是哪一格填错了。排查的顺序很重要,先看额度范围,再看 Key 和地址,最后才去翻错误码,反过来查容易在细节里绕圈。
先确认这笔免费额度到底管哪些请求
免费额度不一定是全站通吃。不少站是绑定到某个分组或者某几个模型上的,你拿默认分组的 Key 去调另一个分组的模型,就会提示没有权限或者额度不可用。先去站点的公告或额度说明页把适用范围看清楚,这一步花两分钟,能省掉后面一堆瞎试。
- 免费档的并发和频率通常压得很低,请求一多就报 429,看着像额度没了,其实是撞了限速
- 有的站要求账号先完成邮箱验证,甚至绑一下支付方式才把免费额度激活,注册完直接拿 Key 未必算数
- 额度页上显示的剩余量有可能是按天刷新的,跨天前后对不上属正常,别拿旧截图当依据
Key 和接口地址这两格,错一个就全废
报 401 或 403,基本就是 Key 这一侧的问题。最常见的几种:粘贴时首尾带了空格、Key 在后台被删过一轮你手里还是旧的、或者复制串了别家的 Key。别嫌麻烦,去站内重新生成一把,用纯文本编辑器过一遍再填进去。
Base URL 是另一个高频坑。站内文档写的是哪个就抄哪个,少写一段路径或者多写一段都会 404。特别注意网页版地址和 API 地址往往不是一个,拿浏览器里那个域名直接拼上去大概率不通。
| 现象 | 先查哪里 | 常见原因 |
|---|---|---|
| 401 / 403 | Key 本身 | 带空格、已失效、复制成别家 Key |
| 404 | Base URL | 路径不全或多写了一段 |
| 换分组后立刻被拒 | Key 与分组绑定 | 旧 Key 调新分组,需要重新生成 |
| 请求发出但界面无反应 | 调用记录页 | 请求没到业务层,地址多半写错 |
模型名对不上,报错长得像额度问题
中转站的模型名经常是站内自己定义的一串,跟官方原名不完全一样。手打基本必错,直接去站内模型列表复制。写了一个站内不存在的名字,返回的提示往往很含糊,容易被误读成没额度。这件事说白了就是别信自己的记性,信复制粘贴。
测试的时候用最简单的单条请求,别一上来就塞长上下文、多轮对话、工具调用。变量一多,报错你分不清是模型名的问题还是参数格式的问题。先用最小请求打通,再一层层加复杂度。
- 复制模型名从站内模型列表原样复制,别手打,注意有没有前后缀
- 发一条最小请求单条短消息、默认参数,看能不能拿到正常返回
- 逐项加参数通了之后再试长上下文、多轮或工具调用,坏了就说明是那一项的问题
看懂返回内容,别只看界面红字
界面上那行红字信息量很小,把完整返回体展开看 code 和 message。额度耗尽、限速、无权限、参数错误是四类完全不同的原因,对应的处理动作也不一样。很多人卡在这一步,是因为压根没打开完整返回,一直在猜。
站内一般有调用记录或者用量页,翻一下这次请求到底有没有被记一笔。没记录说明请求根本没走到业务层,问题在地址或网络这一层;有记录但标了失败,那才是业务层拒了你,看错误码细分。连续失败的时候先停手,短时间反复重试容易触发风控,账号可能被临时限制几个小时。
排完还是不通,就别在免费额度上耗了
同一套配置,换个模型能通,那就说明是那个模型或分组的问题,不是你的配置。这种时候别再自己折腾,直接把调用记录截图丢给站内客服,让他们查。判断标准很简单:你能复现、换个模型就好,责任就在对面。
另一种情况是站点本身不靠谱:连文档和用量页都没有,客服只回一句「稍后再试」。这种站不值得为免费额度继续耗时间,换个站试。免费额度适合验证可用性,真要跑业务之前,拿站内比价页算一遍实际用量成本,别把流程建在随时会变的免费档上。
下一步:先看这家站靠不靠谱配置能通不代表站点值得长期用,去站内中转站导航里对一下可信度检测和价格追踪,再决定要不要把业务压上去。→常见问题
免费额度显示还在,但一调就报没额度,为什么?
常见是额度按分组或按模型单独计算,你查的是总额,实际扣的是另一个分组。也可能是当天的免费次数已经用完而总量还没刷。去站内用量页按分组看明细,比看总数准。
换了 Key 还是 401,是账号被封了吗?
先别下这个结论。多数是 Key 复制时带了不可见字符,或者把接口地址填成了网页域名。最省事的办法是照站内文档里的示例代码原样跑一遍,能通再改自己的代码。
免费额度能不能拿来做正式项目?
不建议。免费档一般有限速、限模型、随时可能调整。拿它验证链路和模型效果没问题,正式跑之前先用小额充值测一轮稳定性和计费口径,再决定要不要长期用这家。