用 curl 调模型接口:7 种报错的真实样子和 3 个坑
拿一个真实 key 对着开放接口发了十几条请求,把 7 种报错的原文和状态码记成一张对照表。三个坑:少写 /v1 返回的是网页、推理模型会把输出预算吃光、同一个模型名几次调用行为不一样。
测什么#
第一次接模型接口的人,卡住的地方往往不是「怎么发请求」,而是「报错了不知道是哪一层的问题」。
这次只测一件事:把常见错误做法各发一遍,把服务器真实返回的样子记下来,做成一张能对照排查的表。变量一次只改一个,其余保持不动。
条件#
| 项 | 内容 |
|---|---|
| 日期 | 2026-10-26,北京时间 06:30—06:50 |
| 工具 | curl 8.11.0(Windows) |
| 目标 | 诸葛智算开放接口 https://zhugeai.cn/v1 |
| 账号 | 一个已注册账号的 key(本文全程用 sk-你的key 占位,不展示真 key) |
| 计时 | curl 的 time_total,含本机到服务器的网络往返 |
| 范围 | 只测了 3 个对话模型中的 2 个;列表里其余模型没有逐个调用 |
结果#
一、报错对照表#
| 场景 | 状态码 | 返回体(节选,原文照抄) | 说明 |
|---|---|---|---|
| 不带 Authorization 头 | 401 | {"error":{"code":"invalid_api_key","message":"Authorization or x-api-key header is required"}} | 请求没进鉴权层 |
| key 写错 | 401 | {"error":{"code":"","message":"Invalid token (request id: 2026…)","type":"new_api_error"}} | 进了鉴权层被拒,带 request id |
| 模型名写错 | 503 | {"code":"model_not_found","message":"No available channel for model gpt-999-not-exist under group default (distributor)"} | 客户端写错也会给 5xx |
| messages 传空数组 | 500 | {"message":"field messages is required","code":"invalid_request"} | 参数问题却给 500,别只看状态码 |
地址少写 /v1 | 200 | 一整页 HTML(网页标题「诸葛凌云」) | 见坑 1 |
| 上游通道失败 | 502 | {"code":"upstream_unavailable","message":"upstream request failed"} | 见坑 3 |
| 正常调用 | 200 | choices[0].message.content 有正文 | — |
两个 401 长得不一样,这本身就是信息:返回 invalid_api_key 说明 header 根本没带上;返回 Invalid token 说明 header 到了、key 被判无效。 报障时把 request id 一起给过去,对方能直接查。
二、两次正常调用的耗时#
| 模型 | 参数 | 状态码 | 耗时 | content |
|---|---|---|---|---|
| deepseek-v4.1-flash | max_tokens=1024 | 200 | 2.26 秒 | 有正文 |
| deepseek-v4.1-flash | max_tokens=16 | 200 | 0.81 秒 | 空 |
| deepseek-v4-flash | stream=false | 502 | 120.06 秒 | 无 |
| deepseek-v4-flash | stream=true | 200 | 120.12 秒 | 有(流式分片) |
| deepseek-v4-flash | 另一次重试 | 502 | 120.07 秒 | 无 |
| deepseek-v4-flash | 90 秒客户端超时 | 无响应 | 90.00 秒 | 无 |
另外一次对 deepseek-v4-flash 的非流式调用等了 90 秒没有任何返回,被客户端主动掐断(状态码显示 000)。四次里成功一次,失败三次,都在 120 秒附近出结果。
三、模型列表#
GET /v1/models 返回 200,本次看到 13 个模型 id:deepseek-v4-flash、deepseek-v4-pro、deepseek-v4.1-flash、doubao-seedance-2.0、doubao-seedance-2.0-fast、doubao-seedance-2.0-mini、doubao-seedance-2.5、glm-5.3、kimi-k3、qwen3.7-max、qwen3.7-plus、qwen3.8-flash、qwen3.8-max。
注意:列表里有,不等于每个都能正常出结果。这次实测只有两个,其中一个在测试时段内三次失败。
意外#
三个和预期不一样的地方。
坑 1:少写 /v1 不报错,返回一个网页#
请求发到 https://zhugeai.cn/chat/completions(少了 /v1),服务器返回 200,body 是一整页 HTML。
这意味着客户端不会说「地址错了」,而是报一句 JSON 解析失败之类的话,人会以为是参数问题,反复改参数。排查第一步永远是确认地址里 /v1 在不在,并且看一眼返回体是 JSON 还是 HTML。
坑 2:状态码 200 不等于成功,content 可能是空的#
deepseek-v4.1-flash 是推理型模型,回答前会先「想」。max_tokens=16 时,返回体里 completion_tokens=15、其中 reasoning_tokens=15——输出预算全被思考过程吃掉,content 是空字符串,finish_reason 是 length。
请求是「成功的」,钱也走了,但你什么也没拿到。判断有没有调通,要看三样:状态码、content 是否非空、finish_reason 是不是 stop。给推理型模型的 max_tokens 要留足余量。
坑 3:同一个模型名,几次调用行为不一样#
deepseek-v4-flash 在 06:30—06:50 这二十分钟里:一次 200(120 秒)、一次 90 秒无响应、两次 502(都是约 120 秒返回 upstream_unavailable)。
失败不是恒定的,间隔固定在 120 秒附近,更像上游通道超时而不是请求写错。排查顺序应该是:先换一个模型发同样的请求。换了就通,问题在模型通道;换哪个都不通,再查自己的代码。
顺带一个对账用的细节:请求里写 deepseek-v4.1-flash,返回体的 model 字段是 deepseek-v4-1-flash-261017;写 deepseek-v4-flash,返回 deepseek-v4-flash-ga-260731。返回的是通道里的实际版本号,和你填的名字不完全一样,按返回字段核对时别以为自己调错了模型。
结论#
在上述条件内可以复现的结论:
- 七种常见问题里,只有「少写 /v1」会给你 200,其余都有状态码或 error 字段可查。拿到 200 先确认返回体是 JSON。
- 状态码只能筛掉一半问题。剩下一半要靠
error.code、error.message、finish_reason和content是否为空。 - 推理型模型要把 max_tokens 放大,否则空回复不是故障。
- 同一模型连续失败、且每次都在同一时长附近结束,先换模型对照,别先改代码。
边界条件:本文只测了一个账号、一个时段(2026-10-26 06:30—06:50)、两个模型、非流式为主。其他时段、其他模型的表现可能不同,报错原文以你实际收到的为准。
本文由 AI 生成,表内状态码、耗时、返回体均为上述条件下的实测记录。
关于准确性:文中「实测」均来自我们自己的机器,标注了日期;厂商参数以官方文档为准。发现错误,告诉我们,会改并记一笔。