鉴权方式

Base URL 在哪拿、三种协议分别怎么鉴权(Bearer / x-api-key / x-goog-api-key)。

每次调用都需要两样东西:API 密钥(证明你是谁)和 Base URL(请求发到哪里)。两者都能在控制台拿到。

获取 Base URL

登录控制台,打开任意模型卡片上的「快速接入」弹窗(或账户概览的接入指引),在协议下拉中选择你要用的协议,复制对应的 Base URL。

  • 不同协议的 Base URL 路径前缀不同,以弹窗里复制的为准;
  • 本文示例统一写为 https://<your-base-url>,请替换成你的实际地址。

三种协议的鉴权方式

协议鉴权请求头备注
OpenAI 兼容Authorization: Bearer YOUR_API_KEY与 OpenAI 官方 SDK 兼容,填 api_key + base_url 即可
Anthropicx-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01版本头必带,SDK 会自动携带
Geminix-goog-api-key: YOUR_API_KEY模型 ID 直接写进 URL 路径

鉴权常见错误

  • 401 Unauthorized:密钥不正确、已被删除或已过期。核对你用的是创建密钥时保存的完整值,注意首尾不要混入空格或换行。
  • 密钥放在了前端:浏览器端代码任何人可见,密钥只能放在服务端或本地环境变量中。
  • 多把密钥混淆:每把密钥独立计上限,确认用对了环境的密钥(生产 / 测试)。

密钥的创建与保管见创建 API 密钥。