Zorveus LogoZorveusDOCS

Zorveus documentation

View Markdown

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.

Optional key for interactive API requests. Stored in memory only.

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.


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.

Client SDK / Framework:
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.

Client SDK / Framework:
# 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

SurfaceProduction EndpointUsage
Inference Gatewayhttps://api.zorveus.com/v1OpenAI-compatible inference (/chat/completions, /models, etc.)
Product & Management APIhttps://api.zorveus.comProgrammatic management with a service key (zrv_svc_...)
Developer Dashboardhttps://app.zorveus.comWeb UI for workspace management, keys, wallets, and OAuth consent

Explore by topic

Was this page helpful?
Edit this page on GitHub

On this page