结论
- 401 通常是认证、endpoint、模型权限或客户端 preset 问题，不是模型质量问题。
- endpoint 和模型名以官方 DashScope compatible-mode 文档为准。
- 先用 curl 测，区分 provider 设置问题和 SDK/工具配置问题。
- Agent 场景要把 Qwen 放在可配置路线后，并准备 fallback。
怎么做
- 确认 API key 属于正确 DashScope/Model Studio 账号，未过期且复制时没有空格。
- 复制官方 OpenAI-compatible base_url，并在 SDK 或工具里显式设置。
- 使用账号当前有权限访问的 Qwen 模型名。
- 在 IDE、Agent 或框架之外先跑最小 curl 请求。
- 如果 curl 成功但应用失败，检查 provider preset、环境变量名、代理和 base_url 是否被覆盖。
推荐路径对比
| 平台 | 免费/额度 | 适合 |
|---|---|---|
| 通义千问 DashScope | 注册额度变化 | 官方兼容模式和 Qwen 模型 |
| OpenAI SDK 清单 | 配置检查 | 核验 base_url、key、model |
| Cline/RooCode 设置 | 工具配置 | 代码 Agent 自定义 endpoint 检查 |
| GLM unauthorized 排错 | 排错模式 | 对比兼容 endpoint 鉴权错误 |
| OpenLLMAPI | 体验额度变化 | Qwen 配置卡住时用统一 endpoint 和 fallback |
自有平台承接
不要在每个工具里重复排 endpoint
用一个兼容 endpoint 加路线日志和 fallback，避免 Qwen 设置问题卡住 Agent 或应用。
FAQ
Qwen 支持 OpenAI-compatible client 吗？
DashScope 为常见 chat workflow 提供 compatible-mode 路径。要使用当前官方 endpoint 和模型名，旧示例很容易失效。
为什么 curl 成功但 Agent 失败？
Agent 可能覆盖 base_url、使用 provider preset、读取不同环境变量，或 fallback 到默认 OpenAI endpoint。
401 可能是额度问题吗？
可能。根据 provider 错误体，可能是 key/账号权限、模型访问、quota 或项目限制。
应该改用网关吗？
只用 Qwen 直连即可。需要 fallback、统一日志，或同一个 key 接 Qwen、DeepSeek、GLM 时，再用网关。