网页版聊得好好的,换成 API 就报错、返回空、或者答得跟网页差一截,多数人第一反应是「模型坏了」。实际用下来,问题大多不在模型,而在你手上这套调用链某一格。这篇按「先分层再动手」给你一条排查顺序:从账号与 Key 开始,到地址与模型名,再到请求本身和额度限制,最后才怀疑模型。
网页版聊得好好的,换成 API 就报错、返回空、或者答得跟网页差一截,多数人第一反应是「模型坏了」,转头就去换模型、换服务商。实际用下来,问题大多不在模型,而在你手上这条调用链的某一格:Key 配错了、地址和 Key 不是一套、模型名凭记忆写了个简写、参数没给全。
这篇给你一条能照着走的排查顺序:先把症状分成「进不去」和「进去了不对」两类,再从账号与 Key 开始,到地址与模型名,到请求本身和额度限制,最后才怀疑模型。顺序别跳,跳着查最费时间。
先把问题分层:是「进不去」还是「进去了不对」
这两种症状的排查路径完全不一样,混着查就会来回打转。请求直接失败——报错、连不上、认证不通过——问题在你和平台之间,账号、Key、地址这三格优先。请求成功但结果不对——答得短、答得乱、跟网页版差很远——问题在请求内容和参数上,模型名、温度、上下文优先。
| 症状 | 先查哪里 | 什么情况可以不这么查 |
|---|---|---|
| 请求直接报错、连不上 | 账号状态、Key、base_url 是否配套 | 如果错误信息明确指向参数格式,直接看请求体 |
| 返回空或只有半句 | 上下文是否超限、最大输出长度是否设得太小 | 如果换一条极短的问题就正常,基本锁定长度问题 |
| 答得跟网页版差很多 | 温度、系统提示词、模型名是否一致 | 如果你本来就想让两边不一样,那不算问题 |
| 偶尔成功偶尔失败 | 并发和频率上限、额度余量 | 网络本身不稳时也会这样,先排除本地网络 |
真正属于模型本身的问题其实很少。先把外面这几层排干净,再怀疑模型,能省下大量换服务商的时间。
Key 和地址这两格,错法比你想的多
Key 粘错是最常见的一类。带了个尾随空格、复制时少了一段、把网页登录后的某个凭证当成 API Key,都会表现成认证失败。我的做法是先把 Key 放到环境变量里,用一条最小请求单独测,不要写在业务代码里反复复制粘贴——写在代码里,你永远不知道改的是哪一份。
地址和 Key 必须是一套。官方地址配官方 Key,中转地址配中转 Key,混着配基本就是认证失败或路径不存在。中转站给的地址经常带自己的路径前缀,少一段、多一段斜杠都会 404,别凭印象拼。
- 把 Key 单独拎出来写进环境变量,新建一个最小脚本只读这个变量;跑通之前不碰业务代码
- 用最小请求试通只发一句话、不带历史、不带自定义参数;能正常返回再往下加东西
- 核对 base_url 和 Key 的来源两者是不是同一个入口发的;中转地址的路径前缀照着对方给的原文抄,不要自己补
- 跑通后再迁回项目把验证过的那套配置整体搬过去,不要在新旧配置之间手动改
请求本身:模型名、参数、上下文三处最容易踩
模型名写错,很多时候不会老老实实告诉你「名字不存在」,而是给个路径错误,或者悄悄换了个兜底模型回你——后者最坑,请求是成功的,输出却明显不对。所以别凭记忆写简写,把完整名称从平台文档里复制过来。
温度和最大输出长度这两项,网页版是平台替你调好的,API 得自己给。默认值和网页版不一致,答出来的风格就会差一截。你如果发现 API 的回答比网页版短、比网页版死板,先看这两个值,而不是急着换模型。
- 模型名:复制完整名称,不写简写、不带多余前缀
- 温度:网页版偏发散,API 默认常常更保守,按用途自己定
- 最大输出长度:设太小会被截断,看起来像「答到一半停了」
- 历史对话:塞太长会超上下文,表现出来是短问正常、聊久了失效
- 系统提示词:网页版有平台预设,API 里得自己补,不补风格就差
上下文超限有个典型特征:一开始都正常,聊到某个长度突然开始报错或答非所问。碰到这种,先把历史砍短再试一次,一次就能确认。
报 429 或者突然没响应,先看额度而不是看代码
额度用完和速率超限,平台给的提示往往长得很像,都像在说「稍后再试」,但处理方式完全不同。额度用完只能补,代码怎么改都没用;速率超限是并发或频率压过了线,调小并发、错峰跑就能过去。
各家的并发口径、频率上限、额度计算方式都不一样,这类数字会变,别记在脑子里。去 /official-api 对应的厂商页看当时的说明,再对照你自己的调用方式判断撞的是哪条线。
还有一点容易忽略:官方直连和中转站两条路的限制项不是一套。你在官方那边调好的并发,换到中转不一定合适;换路之前先确认你撞的是哪条线的限制,别拿一条线的经验套另一条。
怎么确认真轮到模型了
要比较网页版和 API,输入必须完全一致:同一段提示词、同一份上下文、同样的系统设定。差一句话,结果就能差很远,这种对比做出来没有意义。两边都跑一遍,把输出放在一起看,而不是凭印象说「感觉不一样」。
如果输入一致、结果还是差,先量一遍延迟和返回情况,把「慢」和「答错」分开。慢是链路问题,答错才可能跟模型有关。用 /tools/speed-test 先建一条基线,之后每次改动都拿它对比。
确认是模型差异之后,再去 /models 对照规格看当时的资料,别拿不同版本、不同规格的模型输出互相比——那种比较得出的结论基本不能用。
下一步照着上面的顺序走完还没定位,就去站内的中转站导航逐个核对可信度和当前状态,别在一个来路不明的入口上反复试。→常见问题
网页版能用,API 一直报 401,是不是账号被封了?
先别往封号上想。401 基本都是 Key 这一格的问题:粘错、带空格、用了网页登录态、或者 Key 和 base_url 不是同一家的。把 Key 单独写进环境变量,用一条最小请求测通,再看业务代码。
同一个问题,API 和网页版答案不一样,正常吗?
正常。参数默认值不同、上下文长度不同、有时连模型档位都不同。想让两边可比,得把提示词、参数、历史对话长度都对成一样,再跑一次。对不齐就比,等于比了两件事。
报 429 是额度没了还是被限速了?
看提示语和额度页一起判断:额度页还有余量,多半是速率或并发超限,错峰或降并发即可;余量见底就是额度问题,只能补。中转站和官方两条线的限制口径不一样,换路前先确认撞的是哪条。