想试免费大模型接口，最卡人的往往不是拿不到 Key，而是不知道用哪个工具去调：网页调试台、命令行、SDK 脚本、IDE 插件各自适合什么场景，哪些能真跑通、哪些只是个展示页。这篇按「调试—验证—接进代码」的顺序给一套挑选标准和动作清单，数字和额度一律让你回站内页面自己对。
想试免费大模型接口，最卡人的往往不是拿不到 Key，而是不知道用哪个工具去调。有人上来就装一整套客户端，结果发现连端点对不对都没验证过，排查问题时还多了一层遮挡。
这篇按「调试—验证—接进代码」的顺序，给一套挑选标准和动作清单。额度、速率、可用模型这些会变的数字，一律让你回站内页面自己对，本文只讲方法和顺序。
先把工具分成四类，别一上来就装客户端
| 工具类型 | 适合干什么 | 明显短板 |
|---|---|---|
| 在线调试台 | 浏览器填 Key 和 URL 发一次请求，看原始返回 | 难做批量、难参数化 |
| 命令行 / curl | 复现问题、贴日志给别人看 | 不适合长期开发 |
| 语言 SDK / 自写脚本 | 接进项目、做循环和断言 | 需要环境依赖 |
| 编辑器与聊天客户端 | 日常使用 | 把请求包了一层，排查不直观 |
- 判断标准一句话：目的是「验证」就用前两类，目的是「长期用」再上后两类
- 在线调试台最省事，适合第一次握手，但别指望它做回归
- curl 几乎不吃环境依赖，粘贴日志最方便，问题是参数一多就难维护
- SDK 适合把超时、重试、日志一次性写成公共函数，前期投入换后面省事
- 编辑器插件和聊天客户端适合日常，但排查时它隐藏了真实请求，不建议用来定位问题
按场景挑，比按工具名气挑靠谱
- 只想快速试一次输出用在线调试台或 curl，不装任何东西。验证点是能否拿到一次完整响应，而不是响应好不好看。
- 要对比多个来源同一提示词优先用脚本，把 URL 和 Key 做成变量，改配置就能换源，避免手工重复点击引入误差。
- 要在本地持续开发用 SDK，把超时、重试、日志这些工程项一次写成公共函数，后面换源只改配置。
- 要给非技术同事用用现成聊天客户端，别让人碰命令行，但要提前说明它不适合定位问题。
有个常见误区是按工具名气挑。其实同一件事，验证阶段和长期使用阶段需要的工具完全不是一回事。先想清楚你现在是要「确认它能通」还是「把它用起来」，答案基本就出来了。
第一次调用前必须确认的四件事
- 端点与协议
- 确认给的是 OpenAI 兼容还是 Anthropic 兼容格式，两者请求体字段名不同，混用直接报参数错误
- 鉴权头怎么写
- 是 Bearer 还是自定义头，Key 放 header 还是 query，写错就是 401，别急着怀疑 Key 失效
- 模型名从哪来
- 模型标识以对方文档或目录为准，自己猜名字是最常见的 400 / 404 来源
- 返回结构
- 先用最小请求拿一次完整响应，看清是流式还是一整块，字段有没有缺失
排查顺序建议固定下来：先 curl 再 SDK，先非流式再流式，一次只改一个变量。这个顺序看着笨，但能让你在出问题时快速定位到底哪一层变了。很多人把三个变量一起改，结果通是通了，也不知道是哪个改动起的作用。
curl -sS -X POST "$BASE_URL/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"$MODEL","messages":[{"role":"user","content":"ping"}]}'接进代码前先备好这五样
- 超时：连接超时和读取超时分开设，流式场景读取超时要放宽，否则长回答会被自己掐断
- 重试与退避：只对 5xx 和网络错误重试，401 / 403 / 400 重试没意义，次数要有上限
- 并发与限流：免费额度普遍有速率限制，批量任务要控制同时发起的请求数，遇限流按退避排队而不是硬顶
- 降级：准备一个备用来源或备用模型，主来源不可用时自动切，切换逻辑要能靠配置改而不是改代码
- 日志：至少记请求时间、模型名、状态码、耗时、token 用量口径，否则慢了贵了都说不清
这五样看起来是工程细节，但恰恰决定了你换源时痛不痛。一家 5 人小团队如果一开始就把这些做成公共函数，后面无论接哪个来源都只改配置；没做的话，每换一次来源就是一次小重构。降级那一项尤其容易被忽略，等主来源不通了才临时找备用，通常来不及。
怎么确认它现在真的能用
- 重新做最小连通验证每次换来源或换工具，都重新跑一次最小请求，不要拿上次的成功经验当依据。
- 同一提示词跑两遍看返回是否稳定、延迟是否可接受，波动大的来源不适合放进流程。
- 记录验证结果按时间记下来，形成自己的可用清单，避免每次靠现场试。
- 口径变化就回站内核对免费接口的额度、速率和可用模型经常变，具体数字去站内页面看当时的记录。
为什么强调「现在」能用？因为免费接口的可用性、速率和模型清单是动态的。今天通不代表下周还通，所以别把结论记在脑子里，把验证动作和记录习惯留下来才有用。想横向看各家的实时口径，到 /price-watch 和 /rankings 核对当时的数字，别用旧印象做决策。
下一步先去站内把来源的手册和当时的额度口径过一遍，再照本文顺序做一次最小验证，能少踩很多坑。→常见问题
线上调试台能调通，为什么我写进代码就报错？
绝大多数是请求构造差异：调试台帮你补了鉴权头、Content-Type 或默认模型名，代码里得自己写全。做法是把调试台看到的原始请求（URL、方法、header、body）原样复刻到 curl，curl 通了再换 SDK。另外注意调试台可能默认非流式，你代码里开了流式，解析方式就完全不同。
免费接口和付费接口在调用方式上有区别吗？
调用方式基本一样，差别在限制上：免费档通常速率更低、可用模型更少、并发更紧，还可能出现排队。所以同一套代码要能在两种额度下工作，关键是把并发数、超时和重试做成配置项，而不是写死。判断是否够用，看你单次任务需要多久跑完，而不是看单次调用成不成功。
我该同时接几个来源？
两到三个足够：一个主用一个备用即可，接太多维护成本高于收益。筛选维度按稳定性、延迟、可用模型、限制口径四项看，具体数据到站内相关目录页对照当时的记录。如果你的业务对连续性要求高，值得花时间做主备自动切换；如果只是个人试玩，一个来源加手动切换就行。
