API endpoints
Review endpoints, required headers and versioning before choosing a call path.
On this page
Base URL
OpenAI-compatible https://api.apione.ai/v1
Anthropic-compatible https://api.apione.ai
Gemini-compatible https://api.apione.ai/v1betaHTTPS only. Every protocol lives on the same host and takes the same key — no per-vendor addresses.
Endpoint list
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/chat/completions | Chat completion (OpenAI protocol) |
| POST | /v1/responses | Chat completion (OpenAI Responses protocol) |
| POST | /v1/messages | Chat completion (Anthropic protocol) |
| POST | /v1beta/models/{model}:generateContent | Chat completion (Gemini protocol); stream with :streamGenerateContent |
| GET | /v1/models | Models this key may call |
| GET | /v1/models/{model}/params | One model's supported parameters and billing mode |
| POST | /v1/images/generations | Image generation |
| POST | /v1/images/edits | Image editing |
| POST | /v1/videos | Submit a video generation job |
| GET | /v1/videos/{id} | Video job progress and result |
Common request headers
Authorizationstringone of threeBearer YOUR_APIONE_KEY. The Anthropic protocol also accepts x-api-key and the Gemini protocol x-goog-api-key; send only one per request — several at once are rejected.
Content-Typestringrequiredapplication/json on every POST.
X-Maxx-Request-IDstringOptional trace id of your own (up to 128 printable ASCII characters), recorded as this request's ID and searchable during support.
Common response headers
| Header | Meaning |
|---|---|
X-Maxx-Request-ID | This request's ID. Search it in console › Usage › Request log, and include it when contacting support |
Retry-After | Seconds to wait when rate limited |
Versioning
The /v1 path segment is the major interface version. Backwards-compatible changes — new fields, new optional parameters, new models — ship without a version bump. Breaking changes get a new prefix, announced at least six months before the old one is retired.
Parse responses as a structure that may gain fields. Strict deserialisers that reject unknown keys will break the first time we add one.
Contact us
Something unclear, or need a human? Pick the channel that fits your question.
Supportsupport@apione.ai
WeCom
Telegram
Communityhttps://t.me/apione
Support tickets
Billing & accountConsole › Feedback