大肥鱼AI 情报站
免费额度
实测 7 分钟读完

用 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,别只看状态码
地址少写 /v1200一整页 HTML(网页标题「诸葛凌云」)见坑 1
上游通道失败502{"code":"upstream_unavailable","message":"upstream request failed"}见坑 3
正常调用200choices[0].message.content 有正文—

两个 401 长得不一样,这本身就是信息:返回 invalid_api_key 说明 header 根本没带上;返回 Invalid token 说明 header 到了、key 被判无效。 报障时把 request id 一起给过去,对方能直接查。

二、两次正常调用的耗时#

模型参数状态码耗时content
deepseek-v4.1-flashmax_tokens=10242002.26 秒有正文
deepseek-v4.1-flashmax_tokens=162000.81 秒空
deepseek-v4-flashstream=false502120.06 秒无
deepseek-v4-flashstream=true200120.12 秒有(流式分片)
deepseek-v4-flash另一次重试502120.07 秒无
deepseek-v4-flash90 秒客户端超时无响应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。返回的是通道里的实际版本号,和你填的名字不完全一样,按返回字段核对时别以为自己调错了模型。

结论#

在上述条件内可以复现的结论:

  1. 七种常见问题里,只有「少写 /v1」会给你 200,其余都有状态码或 error 字段可查。拿到 200 先确认返回体是 JSON。
  2. 状态码只能筛掉一半问题。剩下一半要靠 error.code、error.message、finish_reason 和 content 是否为空。
  3. 推理型模型要把 max_tokens 放大,否则空回复不是故障。
  4. 同一模型连续失败、且每次都在同一时长附近结束,先换模型对照,别先改代码。

边界条件:本文只测了一个账号、一个时段(2026-10-26 06:30—06:50)、两个模型、非流式为主。其他时段、其他模型的表现可能不同,报错原文以你实际收到的为准。

本文由 AI 生成,表内状态码、耗时、返回体均为上述条件下的实测记录。

实测API报错排查诸葛智算

关于准确性:文中「实测」均来自我们自己的机器,标注了日期;厂商参数以官方文档为准。发现错误,告诉我们,会改并记一笔。

开始动手

先拿一个能用的 key,再谈别的

诸葛智算注册 5 折起,主流模型一个 key 全通。本站所有教程都按这个接口写,跑不通可以直接问。