通义千问运行报错代码1001

先说清一个关键事实

很多人搜"通义千问报错 1001"想找一个确定含义，但需要先明确：阿里云百炼（DashScope / Model Studio）官方公开的错误标识是字符串形式的 code，而不是四位数字编号。官方接口的错误响应体固定返回三个字段：

{
  "request_id": "xxx",
  "code": "Throttling.AllocationQuota",
  "message": "..."
}

也就是说，官方错误码长这样：InvalidApiKey、ModelNotFound、Throttling.RateQuota、Arrearage、DataInspectionFailed。官方文档中并没有一个叫"1001"的统一错误码定义。

所以当你看到"1001"时，它大概率来自以下三种情况之一：

1. 第三方客户端或中间层自定义的错误编号。很多接了千问 API 的第三方应用会把上游错误重新包装成自己的数字码，1001 常被用作"通用失败"或"鉴权失败"的自定义编号。
2. 某个 SDK / 框架的内部错误码，与千问服务端无关，比如网络层、序列化层的错误。
3. 误读。把 HTTP 状态码、限流窗口数值、或日志里的其他数字当成了错误码。

正确做法：不要以 1001 为线索去查，而是去看 message 文本和 request_id。这两个字段才是能定位问题的依据。

官方错误码对照（用于把 1001 还原成真实原因）

其中 401 有几个容易踩的变体，官方 FAQ 明确列出过：No API-key provided 是请求头没带 Key；Invalid API-key provided 常见于用错了计费模式的 Key、订阅过期或复制不完整（带了空格）；invalid access token or token expired 和 Incorrect API key provided 则通常是 Base URL 与 Key 不配套——例如用套餐专属 Key 却配了通用 Base URL。

排查步骤（按顺序做，不要跳）

1. 拿到完整错误体。打印 HTTP 状态码 + code + message + request_id 四项。只有 message 才能告诉你真实原因。
2. 判断是网页版还是 API。网页版对话出错与 API 调用出错是两条完全不同的链路，不要混着查。网页版报错优先刷新、重新登录、换网络。
3. 如果是 API：先看状态码归类——401 查 Key 与 Base URL，403 查权限与套餐，404 查模型名，429 查限流，5xx 记 request_id 重试或提工单。
4. 如果是第三方客户端报 1001：去该客户端的日志里找它记录的上游原始响应，或打开其调试模式。多数客户端会把上游 body 记在日志中。
5. 确认账号状态。欠费会导致看起来像鉴权失败的报错，先去费用中心确认账号无欠费。
6. 核对 Key 归属。确认调用所用的 API Key 属于当前账号、且与你使用的 Base URL 及套餐类型匹配。
7. 仍无法定位：带上 request_id 与完整 message 提交工单，官方可据此定位单次请求。

使用场景

• 自建服务调用千问 API 时批量报错，需要区分是限流、欠费还是 Key 配置问题。
• 使用第三方客户端接入千问，客户端只显示一个数字码，需要还原真实原因。
• 压测或高并发场景下间歇性失败，需要判断是 RPM 超限还是 TPM 超限。
• 网页版对话异常，需要先判断是否属于服务端问题再决定是否等待。

本页信息来源

错误码对照与 401 变体说明依据阿里云帮助中心的百炼错误码文档、Token Plan 常见问题页与限流应对最佳实践页的公开内容整理；错误响应体的三字段结构（request_id / code / message）来自百炼 OpenAPI 官方接口文档。官方错误码清单会随平台演进增补，请以阿里云帮助中心当前文档为准。本页明确不为"1001"编造官方定义，因为官方并未公开该编号。