Libraries
SDKs & libraries
Oxyy speaks the OpenAI wire format, so the official OpenAI SDK in any language works unchanged. There is no Oxyy SDK to install.
| Language | Package | Install |
|---|---|---|
| Python | openai | pip install openai |
| JavaScript / TypeScript | openai | npm install openai |
| PHP | openai-php/client | composer require openai-php/client |
| Go | sashabaranov/go-openai | go get github.com/sashabaranov/go-openai |
| Ruby | ruby-openai | gem install ruby-openai |
| Java / Kotlin | com.openai:openai-java | Maven / Gradle |
| C# | OpenAI | dotnet add package OpenAI |
Frameworks built on the OpenAI client — LangChain, LlamaIndex, the Vercel AI SDK, PydanticAI, Instructor — work by setting the same base URL in their OpenAI provider.
Vendor SDKs
Claude and Gemini can also be called with their vendor's own SDK: see Anthropic SDK and Google GenAI SDK. A vendor SDK serves only that vendor's models; the OpenAI SDK reaches every model.
Forgiving base URLs. Each vendor SDK appends its own version prefix, which people get wrong in two predictable ways. Both are absorbed rather than 404'd: a base URL with no prefix (
/messages, /responses) and one where the prefix was doubled (/v1/v1/messages, /v1beta/v1beta/…) reach the same pipeline with the same billing.Grok (xAI) and Meta models
xai-sdk is not supported. xAI's official
xai-sdk package speaks gRPC, which this REST API does not serve. Call Grok models with the OpenAI SDK and base_url set to https://api.oxyy.ai/v1.Meta's models are also called through the OpenAI SDK, with chat completions or the Responses API. There is no separate Meta SDK surface.
Differences from other gateways
| Field | Oxyy |
|---|---|
provider (root) | Not returned. The upstream that served a request is intentionally not disclosed. |
usage.cost | The amount charged for the request, in USD — on every response, streaming included. |
usage.is_byok | Always false: every request is served on Oxyy's own provider keys. |
models / route / provider (request) | Not accepted. Fallback and provider choice are handled for you; send one model. |
transforms, plugins | Not accepted. Nothing is injected into or rewritten in your prompt. |