401错误本质是认证链路断裂，非密钥本身错误；需逐层排查：密钥状态与完整性（启用、无空格换行）、服务权限（如qwen-max需单独授权）、Authorization头格式（Bearer后单空格）、Base URL与模型路径匹配性（如qwen-plus须用compatible-mode/v1）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
千问AI API调用返回401错误，说明请求未通过身份认证网关的第一道准入校验，系统甚至没把你的密钥送进鉴权模块比对，此时必须逐层排查认证链路是否断裂。
确认API Key状态与完整性
登录阿里云百炼控制台→进入「API密钥管理」→找到对应密钥，检查其状态是否为“启用”。若显示“已禁用”或“已过期”，直接删除并新建密钥。
复制密钥时务必选中完整字符串，【必须包含sk-前缀，且末尾不能有不可见空格或换行符】。可用命令验证：echo -n "your_key" | xxd | head，若输出末尾出现0a（换行）或20（空格），说明粘贴污染。
检查当前账号是否已开通所调用模型的服务权限，例如qwen-max需单独授权，仅开通“模型试用”权限无法调用付费模型。
检查Authorization请求头构造
方法一：使用DashScope官方SDK（推荐）
安装后直接初始化：import dashscope; dashscope.api_key = "sk-xxx"。SDK自动处理Bearer拼写、空格、编码等细节，避免手写header出错。
Qwen 视频智能分析基础客户端（免费版），基于 Qwen 3.5 Plus 多模态模型对本地视频进行内容分析，支持场景描述与基础内容理解，采用默认抽帧频率和提示词，适合快速概览视频，API Key 读取自 ~/.skill-platform/skill-platform.json 的 skills 配置。
方法二：手动构造HTTP请求头
确保headers中键名为Authorization（首字母大写，无下划线），值格式为Bearer sk-xxx，【Bearer与密钥之间必须且仅有一个英文空格】。常见错误是写成Bearer: sk-xxx或Bearer(sk-xxx)。
方法三：用curl快速验证
curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \<br>-H "Authorization: Bearer sk-xxx" \<br>-H "Content-Type: application/json" \<br>-d '{"model":"qwen-turbo","messages":[{"role":"user","content":"hi"}]}'
验证Base URL与接口路径匹配性
第一步：确认Base URL结尾必须含/v1路径，例如正确地址为https://dashscope.aliyuncs.com/compatible-mode/v1，若漏掉/v1将返回404而非401，但部分网关会统一转为401误导排查方向。
第二步：核对模型ID与Endpoint是否严格对应。qwen-plus必须用compatible-mode/v1，而qwen3-1.7B需走/v1原生路径，混用会导致认证跳过。
第三步：本地部署场景下，运行curl -s http://localhost:8000/v1/models确认服务已启动且响应正常，否则网关层直接拦截，不触发密钥校验。
