认证鉴权
ClawdRouter API 使用 API Key 进行认证。除明确标注为厂商原生协议的接口外，默认使用 Authorization: Bearer YOUR_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 原生协议 | x-api-key: YOUR_API_KEY | 适用于 /v1/messages，并需要 anthropic-version |
Request-Id
你可以在请求中传入 Request-Id 方便排查问题：
Request-Id: order_20260520_0001
该字段建议使用业务侧唯一标识。提交工单时同时提供 Request-Id 和响应中的 traceId，定位会更快。
BYOK
如果你需要使用自己的上游供应商 Key，请先阅读 BYOK（自带 Key）。BYOK 不改变对 ClawdRouter 的认证方式，调用平台接口时仍然使用 ClawdRouter API Key。