认证鉴权
ClawdRouter API 对外统一使用 Authorization: Bearer YOUR_API_KEY。如果你使用 Anthropic 或 Google 原生 SDK 指向 ClawdRouter 代理 URL，SDK 自动生成的 x-api-key 或 x-goog-api-key 会在平台代理层内部转换。
基础请求头
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
建议把 API Key 放在服务端环境变量中，不要写入前端代码、移动端包、公开仓库或日志。
常见协议差异
| 协议 | 认证头 | 说明 |
|---|---|---|
| OpenAI-compatible | Authorization: Bearer YOUR_API_KEY | 适用于 /v1/chat/completions、/v1/responses、/v1/images/generations |
| Google 原生多模态 | Authorization: Bearer YOUR_API_KEY | 适用于 /v1beta/models/{model}:{method} |
| Veo 视频生成 | Authorization: Bearer YOUR_API_KEY | 适用于 /v1/video/generations |
| Anthropic 原生协议 | Authorization: Bearer YOUR_API_KEY | 适用于 /v1/messages，并需要 anthropic-version |
如果 SDK 自动附带 x-api-key 或 x-goog-api-key，平台代理层也会完成内部转换，因此对外文档仍统一以 Bearer 头为准。
Request-Id
你可以在请求中传入 Request-Id 方便排查问题：
Request-Id: order_20260520_0001
该字段建议使用业务侧唯一标识。提交工单时同时提供 Request-Id 和响应中的 traceId，定位会更快。
BYOK
如果你需要使用自己的上游供应商 Key，请先阅读 BYOK（自带 Key）。BYOK 不改变对 ClawdRouter 的认证方式，调用平台接口时仍然使用 ClawdRouter API Key。