- 文档
- 入门
- 兼容性与认证
兼容性与认证
Airoutly 支持四种 API 协议。把 SDK 或工具指向对应的 Base URL，用同一个 API Key 即可，其他代码不用改。
协议与 Base URL
| 协议 | Base URL | 接口 |
|---|---|---|
| OpenAI Chat Completions | https://api.airoutly.com/v1 | POST /v1/chat/completions |
| OpenAI Responses | https://api.airoutly.com/v1 | POST /v1/responses |
| Anthropic Messages | https://api.airoutly.com | POST /v1/messages |
| Gemini | https://api.airoutly.com/v1beta | POST /v1beta/models/{model}:generateContent |
Anthropic SDK 和 Claude Code 会自己拼上 /v1/messages，所以它们的 Base URL 不带 /v1。
认证请求头
所有协议都接受 Authorization: Bearer <key>。各 SDK 自带的请求头同样可用，不需要改 SDK 发送 Key 的方式。
| 协议 | 可用的请求头 |
|---|---|
| OpenAI（Chat、Responses、Embeddings） | Authorization: Bearer sk-… |
| Anthropic Messages | x-api-key: sk-… 或 Authorization: Bearer sk-… |
| Gemini | x-goog-api-key: sk-…、?key=sk-… 或 Authorization: Bearer sk-… |
各协议可调用的模型
- Chat Completions 可以调用 Airoutly 上的所有对话模型，包括 Claude 和 Gemini。
- Messages、Responses 和 Gemini 只能调用在模型页“协议”一列里标有该协议的模型。
- 模型 ID 与官方一致，区分大小写。模型不可用时返回
503 model_not_found。