401 无效令牌

401 Unauthorized 是最常见的问题之一。它通常不表示平台挂了，而是说明当前请求没有通过鉴权。

最常见原因

1. API Key 复制不完整

尤其是在网页里创建后，没有及时保存完整值。

2. 请求头写错

正确写法是：

Authorization: Bearer <你的 API Key>

常见错误包括：

• 少了 Bearer
• Bearer 和 Key 之间没有空格
• 请求头字段名写错

3. Key 中带了空格或换行

从网页复制后，经常会混入不可见字符，导致格式看上去对，实际校验失败。

4. 把网页登录态当成 API 凭证

能登录网页，不代表程序已经具备可调用接口的凭证。

排查步骤

1. 在控制台重新创建一个新的 API Key
2. 用最小 curl 请求直接验证
3. 如果 curl 能通，再回到第三方客户端或 SDK 继续排查
4. 如果 curl 也不通，就继续检查 Key 本身和请求头格式

最小验证命令

curl https://yunqiaoai.com.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "ping"}]
  }'