身份验证
了解如何发送密钥、各格式要求使用哪个请求头，以及如何保障密钥安全。
每个请求都需要使用在控制台创建的 API 密钥。密钥以 sk- 开头，并使用创建该密钥的账户的权限和余额。
两种请求头，同一个密钥
同一个密钥适用于两种格式——只有请求头名称不同。
| 格式 | 端点 | 请求头 |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
Anthropic 格式还需要版本请求头。所有 Anthropic SDK 都会自动设置：
-H "anthropic-version: 2023-06-01"环境变量
大多数工具会读取这些环境变量，而不是通过参数接收密钥：
| 变量 | 使用方 | 值 |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code、Anthropic SDK | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | 您的 sk- 键 |
ANTHROPIC_API_KEY | Anthropic SDK（Python/TS） | 您的 sk- 键 |
OPENAI_BASE_URL | OpenAI SDK、LangChain、LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | OpenAI SDK | 您的 sk- 键 |
请注意
/v1 后缀需添加到 OPENAI_BASE_URL ，但不添加到 ANTHROPIC_BASE_URL。这种差异来自官方 SDK，并非由我们引入——OpenAI 客户端会将路径追加到您提供的基础地址后，Anthropic 客户端则会自行追加 /v1 。这里配置错误是最常见的设置问题。密钥安全管理
- 创建一个 为每台机器或每个项目使用独立密钥 ，以便撤销其中一个密钥而不影响其他密钥。
- 切勿将密钥提交到代码仓库。请使用环境变量或密钥管理器；添加
.env变为.gitignore. - 密钥仅会完整显示 一次。密钥丢失后应更换，而不是尝试找回。
- 泄露的密钥会消耗您的余额。请立即在控制台撤销——撤销即时生效。
- 优先从服务端发起调用。随浏览器打包文件或移动应用分发的密钥等同于公开密钥。
撤销与轮换
- 控制台 → API 密钥.
- 先创建替代密钥并部署。
- 流量切换完成后，删除旧密钥。使用旧密钥的进行中请求会在删除后立即失败。