身份认证 — Claude API Key 配置
如何获取、使用与保护 LLMsRelay API Key。支持 Anthropic 和 OpenAI 两种鉴权方式。
LLMsRelay 是独立运营的 API 网关,与 Anthropic, PBC 无隶属或授权关系。产品和模型名称仅用于说明兼容性。
鉴权方式
LLMsRelay 同时支持两种鉴权 Header:
Anthropic 格式bash
x-api-key: sk-cs4-...
anthropic-version: 2023-06-01OpenAI 格式bash
Authorization: Bearer sk-cs4-...环境变量(推荐)
bash / zshbash
export ANTHROPIC_API_KEY=sk-cs4-...
export ANTHROPIC_BASE_URL=https://api.llmsrelay.com安全建议
- 使用环境变量或密钥管理服务(如 1Password、Vault)。
- 定期轮换 Key,发现异常立即吊销。
- 仅在后端服务器调用 API,避免在浏览器/移动端暴露 Key。
- 启用积分用量提醒(用户后台设置)。
验证配置
验证 gateway 访问
在发送真实请求之前,先做两个低成本检查:健康探测和模型列表。它们能确认 base URL、网络以及(对于 /v1/models)你的 API key — 完全不消耗额度。
1. 存活探测 — /healthz
公开端点,无需鉴权。gateway 在线时返回 200 和 JSON 状态。可在 CI、监控或任何 shell 中使用。
curl -sS -o /dev/null -w "HTTP %{http_code}\n" \
https://api.llmsrelay.com/healthz2. 鉴权 + 模型目录 — /v1/models
返回 /v1/messages 可用的模型 ID 列表。需要有效的 x-api-key。如果通过,说明 key、base URL 和请求头都正确。
curl -sS https://api.llmsrelay.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | jq '.data[].id'