Start here
The OneAPI API
One key and one base URL in front of many model providers. Keep the SDK your code already uses, change the base URL, and pick a model by its ID.
https://api.oneapi.id/v1- Key header
Authorization: Bearerorx-api-key- Body
- JSON, in the format of the path you call
- Billing
- Per token, from prepaid credit or a plan
How a request is routed
Two parts of a request matter to the gateway, and they are independent. The path decides which wire format you send and get back. The model field decides which model answers. A Claude model can be called through the OpenAI Chat Completions path, and a GPT model through the Anthropic Messages path; the gateway converts between formats on the way in and out.
/v1/chat/completionsOpenAI Chat Completions/v1/responsesOpenAI Responses/v1/messagesAnthropic Messages
api.oneapi.id/v1"model" fieldAny model in the catalogmodel field decides which model answers. Every listed model works on every path.Conversion covers messages, system prompts, tools and streaming. A feature that one format has and the other cannot express, such as a provider-hosted tool, is refused with 400 unsupported_parameter instead of being dropped silently. See Errors.
Pick an endpoint
Call the path that matches the client you already have. There is no need to rewrite request bodies.
| If your code uses | Call | Reference |
|---|---|---|
| OpenAI SDK, chat.completions | POST /v1/chat/completions | Chat Completions |
| OpenAI SDK, responses | POST /v1/responses | Responses |
| Anthropic SDK, messages | POST /v1/messages | Messages |
| Anything that lists models | GET /v1/models | Models |
| Checking your balance | GET /v1/me | Me |
Most tools that let you set an OpenAI base URL work unchanged. Tools built on the Anthropic SDK need the base URL without /v1; Official SDKs shows both.
Where to go next
- Quickstart: create a key and send a first request.
- Authentication: headers, key format, per-key spend caps.
- Models: every model ID you can call, with prices.
- Billing and limits: how a request is charged and what can refuse it.