- Docs
- Get started
- Compatibility & auth
Compatibility and authentication
Airoutly speaks four API protocols. Point your SDK or tool at the matching Base URL and send the same API key; no other code changes are needed.
Protocols and Base URLs
| Protocol | Base URL | Endpoint |
|---|---|---|
| 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 |
The Anthropic SDKs and Claude Code add /v1/messages themselves, so their Base URL has no /v1.
Auth headers
Every protocol accepts Authorization: Bearer <key>. The native headers of each SDK work too, so you never have to change how an SDK sends the key.
| Protocol | Headers accepted |
|---|---|
| OpenAI (Chat, Responses, Embeddings) | Authorization: Bearer sk-… |
| Anthropic Messages | x-api-key: sk-… or Authorization: Bearer sk-… |
| Gemini | x-goog-api-key: sk-…, ?key=sk-… or Authorization: Bearer sk-… |
Which models each protocol reaches
- Chat Completions reaches every chat model on Airoutly, including Claude and Gemini.
- Messages, Responses and Gemini reach the models that list that protocol in the Endpoints column of the models page.
- Model IDs are the official ones and are case-sensitive. A model that isn’t available returns
503 model_not_found.