鉴权方式
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 即可 |
| Anthropic | x-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01 | 版本头必带,SDK 会自动携带 |
| Gemini | x-goog-api-key: YOUR_API_KEY | 模型 ID 直接写进 URL 路径 |
鉴权常见错误
- 401 Unauthorized:密钥不正确、已被删除或已过期。核对你用的是创建密钥时保存的完整值,注意首尾不要混入空格或换行。
- 密钥放在了前端:浏览器端代码任何人可见,密钥只能放在服务端或本地环境变量中。
- 多把密钥混淆:每把密钥独立计上限,确认用对了环境的密钥(生产 / 测试)。
密钥的创建与保管见创建 API 密钥。

