首页/AI/AI 应用速查/API 鉴权头速查(Bearer / x-api-key / api-key)
本包目录(159 条)

API 鉴权头速查(Bearer / x-api-key / api-key)

三家主流鉴权风格:OpenAI 与兼容生态用 Authorization: Bearer;Anthropic 用 x-api-key(另需版本头);Azure OpenAI 用 api-key。头名写错是最常见的 401 原因。

AI 应用速查AI更新于 2026-10-12

平台与鉴权头对照

平台鉴权头备注
OpenAI 及兼容生态Authorization: Bearer <key>Bearer 后有空格
Anthropicx-api-key: <key>加 anthropic-version 头
Azure OpenAIapi-key: <key>也可用 Entra ID Token
Geminix-goog-api-key: <key>或 ?key= 查询参数(不推荐)

三种头写法(curl)

三种头写法(curl)
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY"
curl -s https://api.anthropic.com/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01"
curl -s "https://RESOURCE.openai.azure.com/openai/models?api-version=2024-10-21" -H "api-key: $AZURE_OPENAI_KEY"
API Key 只放环境变量或密钥管理服务;绝不进代码仓库、客户端包与日志。

易错点

  • 401 先排查头名拼写与 Bearer 后空格
  • 把多个平台的 key 混用(头名对但 key 是别家的)

数据来源与参考

  • OpenAI / Anthropic / Microsoft Learn 鉴权文档

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌