国内免费的大模型api怎么排查，步骤和注意事项

免费 API 用着用着突然报错，最常见的情况不是平台跑路，而是你把额度用完、限速打满、或者请求格式不对。这篇给一条排查顺序：先确认免费范围和剩余额度，再验证接口能不能通，然后看限速和并发，最后查账号与密钥状态。每一步都有可执行的动作和判断标准，也标了哪些情况这套方法不适用。

免费的大模型 API 用着用着突然报错，很多人第一反应是平台出问题了。实际上更常见的原因是自己这边：额度用完了、限速打满了、请求参数平台压根不支持，或者密钥早就失效了。先别急着换平台，按一条固定顺序排查一遍，八成问题能自己定位。

下面这条排查线分四步：确认免费范围、验证接口连通、查限速与并发、查账号与密钥状态。每一步都给了具体动作和判断标准，也标了哪些情况这套方法不适用。免费档本身没有稳定性承诺，所以排查的目标不是「让它永远不挂」，而是分清是平台限制还是自己配错了。

第一步：先确认这个免费到底免的是什么

免费有好几种形式，表现完全不一样：有的平台是限时活动，到期直接停；有的是送固定额度，用完就报额度不足；还有的是某几个小模型长期免费，大模型照样收费。你遇到的报错属于哪一种，决定了后面还要不要继续查接口。

限时活动免费

到期后整批模型一起失效，通常控制台会显示活动结束，不是你的配置问题

固定额度免费

额度用完就报余额或配额类错误，换个模型可能还有剩余额度

特定模型长期免费

只有名单内的小模型免费，你调大模型报错很正常，换模型即可

动作很直接：登录平台控制台，看剩余额度、有效期、可用模型清单三样东西，别只看宣传页文案。然后到站内的免费模型名单页核对当前哪些还在名单里，比如 /official-api/providers/siliconflow 和 /official-api/providers/modelscope，具体数字以页面当时显示的为准。

第二步：把问题拆成网络、鉴权、参数三层

额度没问题还报错，就先做一次最简请求：只发一句话，不开流式、不带工具调用、不传图片、不加长上下文。返回码落在哪一档，基本就指向哪一层的问题。

如果连最简请求都发不出去，先把「服务活着」和「你调得对」分开验证。可以参照站内 /tools/verify 的检测思路：先确认端点可达，再确认鉴权通过，最后才看业务参数。

1. 发最简请求单条消息、非流式、默认参数，记录返回码和错误信息原文
2. 换官方示例复测用平台文档里的示例代码原样跑一次，排除自己封装的干扰
3. 对照返回码表按上表定位到具体一层，只改那一层的东西，别一次改多处

第三步：限速、并发和超时，免费档最容易卡在这

免费档一般同时限制每分钟请求数和每分钟 token 数，长 prompt 往往先撞 token 限额而不是请求数。表现是前几个请求正常，跑一会儿开始间歇失败，或者批量任务里一部分成功一部分 429。

• 看到 429 先看响应头里的重试时间，按它等，别原地循环重试把限速窗口刷得更死
• 给请求加退避重试和本地排队，批量任务错峰跑，不要并发打满
• 用站内 /tools/speed-test 先量出延迟基线，避免把「慢」当成「挂」
• 区分 429 和超时：429 是平台让你慢点，超时可能是你的等待时间设太短

不适用的情况要说清楚：如果你要跑生产流量、高并发批处理或者对延迟有硬要求，免费档本身就不该选，再怎么调参数也解决不了容量问题，直接去看站内 /official-api 的付费档对比。

第四步：账号、实名和密钥状态

前三步都过了还失败，问题往往在账号层。国内平台多数要求实名或绑定手机，未完成实名的账号可能直接调不通，或者额度显示为零。密钥本身也可能被删、过期，或者绑了 IP 白名单。

• 新建一个密钥复测：能通说明旧密钥有问题，不能通再往账号状态查
• 检查密钥是否绑定了来源 IP 或域名限制，换网络环境测试一次
• 同一账号多设备多 IP 频繁切换可能触发风控，表现是间歇性失败而不是全挂
• 确认账号实名状态和手机绑定，这两项没完成时很多平台不给调用权限

还有一个容易被忽略的点：部分平台对免费档单独做了内容审核策略，错误信息看起来像接口失败，其实是审核拦截。这类情况换提示词或换模型比调接口有用。

什么时候这套排查不适用

这套顺序是为「免费档偶发失败」设计的，以下几种情况别硬套。

• 免费档没有稳定性承诺，偶发失败不值得深挖，重要任务必须留备用通道
• 错误集中在内容审核拦截时，那不是技术故障，换提示词或换模型
• 涉及数据合规的场景，免费档的条款要单独看，不要默认和付费档一致
• 平台整体故障时，排查自己这边没有意义，先看平台状态页和社区反馈

排查的目的是分清责任边界：是平台不给，还是自己配错。分清之后，该换就换，该改就改。