鉴权

清霄 API 使用控制台签发的用户令牌（常见前缀 sk-）。

OpenAI 兼容路径（Chat / Responses / 视频）

Authorization: Bearer sk-YOUR_KEY

curl -sS "https://api.qingxiaocloud.com/v1/models" \
  -H "Authorization: Bearer sk-YOUR_KEY"

未带密钥或密钥无效时，通常返回 401。

Anthropic Messages

路径 POST /v1/messages 需同时带 Anthropic 版本头。密钥可用 Bearer，也可用 x-api-key：

x-api-key: sk-YOUR_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

或：

Authorization: Bearer sk-YOUR_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

密钥管理建议

建议	说明
仅在服务端使用	不要把密钥打进浏览器 / 移动端包体
环境变量注入	如 QX_API_KEY；CI 用密钥库，勿写进仓库
按环境拆分	开发 / 生产使用不同 Key，便于吊销
泄露即轮换	怀疑泄露时立即在控制台禁用并重建

常见错误

现象	可能原因
401	Key 错误、已禁用、复制多余空格
403 / 额度相关	余额不足、Key 被限制（以控制台提示为准）

更完整说明见 错误与限制。