Zorveus documentation
Zorveus is an AI wallet, billing layer, and multi-provider gateway designed for two main developer workflows.
Zorveus sits between your application and model providers (OpenAI, Anthropic, Gemini, OpenRouter), giving you unified AI inference, spending controls, and flexible wallet billing.
Choose your developer path
For an end-to-end organization-funded integration, start with Integrate your product. For agent-readable source and a copyable prompt, use Integrate with a coding agent.
Businesses & AI Product Builders
Build AI products funded by your organization. Add multi-provider inference, meter end-user consumption, set per-user credit limits, and control AI spend through one API.
Third-Party App Developers
Let users pay for AI with their own Zorveus wallets. Integrate OAuth 2.0 with PKCE so users authorize your app to charge their personal or company AI wallets directly.
Quickstart
You can use the official Zorveus SDKs (@zorveus/sdk for TypeScript, zorveus for Python), framework adapters (@zorveus/sdk/openai, @zorveus/sdk/vercel, zorveus[openai]), or point any OpenAI-compatible client to https://api.zorveus.com/v1.
import { Zorveus } from "@zorveus/sdk";
const client = new Zorveus({
apiKey: "zrv_your_api_key",
});
async function main() {
const completion = await client.chat.completions.create({
model: "openai/gpt-4.1-mini",
messages: [
{ role: "user", content: "Explain quantum computing in one sentence." },
],
});
console.log(completion.choices[0].message.content);
}
main();Official SDKs and framework adapters
Zorveus provides official SDK packages for TypeScript and Python, along with drop-in adapters for standard frameworks like OpenAI and Vercel AI SDK:
@zorveus/sdk
Core TypeScript SDK
npm install @zorveus/sdk
Native TypeScript/JavaScript client for inference, management, and PKCE.
zorveus
Core Python SDK
pip install zorveus
Typed Python 3.9+ client with sync and async httpx transports.
@zorveus/react
React Hooks & UI
npm install @zorveus/react
Providers, useZorveusInference, useZorveusSpend, and pre-built UI components.
Framework adapters
Framework adapters let you keep your existing OpenAI or Vercel AI SDK code while routing inference through Zorveus. They can attach product-user attribution. The gateway, not the adapter, enforces the connection’s caps, credit mode, and funding policy.
# pip install zorveus[openai]
from zorveus.openai import ZorveusOpenAI
# Drop-in wrapper for official OpenAI Python SDK
client = ZorveusOpenAI(
api_key="zrv_your_api_key",
external_user_id="usr_sara_101",
display_name="Sara Connor"
)
response = client.chat.completions.create(
model="openai/gpt-4.1-mini",
messages=[{"role": "user", "content": "Hello!"}]
)Production base URLs
| Surface | Production Endpoint | Usage |
|---|---|---|
| Inference Gateway | https://api.zorveus.com/v1 | OpenAI-compatible inference (/chat/completions, /models, etc.) |
| Product & Management API | https://api.zorveus.com | Programmatic management with a service key (zrv_svc_...) |
| Developer Dashboard | https://app.zorveus.com | Web UI for workspace management, keys, wallets, and OAuth consent |
Explore by topic
Inference Capabilities
Chat completions, streaming, tool calling, responses API, embeddings, and model discovery.
Product Users & Attribution
Track end-user AI usage with inline metadata and apply custom credit grants.
Bring Your Own Key (BYOK)
Route requests through your own encrypted OpenAI, Anthropic, Gemini, or OpenRouter keys.
OAuth PKCE Integration
Build connectable applications that charge user-selected funding organizations.