Rouva Docs

Everything you need to connect your app to Rouva — from a quick start to the full API reference.

Quick start

Connect your app to Rouva in three steps. No infrastructure changes required.

1. Create an account
   Sign up at app.rouva.io and connect your Anthropic or OpenAI API key in Settings.
2. Generate your Rouva gateway key
   Go to Integrations in your dashboard and click Generate API key. Your key starts with rva_.
3. Route your first request
   Use the SDK or call the gateway directly. Rouva handles the rest.

SDK

The official Node.js SDK is the fastest way to integrate. One client for Anthropic and OpenAI — drop-in compatible with the OpenAI SDK.

Install

npm install @rouvanpm/rouva

Usage

import { Rouva } from '@rouvanpm/rouva'

const rouva = new Rouva({ apiKey: 'rva_your_key' })

const response = await rouva.chat.completions.create({
  messages: [{ role: 'user', content: 'Your prompt here' }],
})

Already using OpenAI or Anthropic?

Change two lines. Rouva uses the same message format — your existing code works as-is.

// Before (OpenAI)
import OpenAI from 'openai'
const openai = new OpenAI({ apiKey: '...' })
const res = await openai.chat.completions.create({ messages, model: 'gpt-4o' })

// Before (Anthropic)
import Anthropic from '@anthropic-ai/sdk'
const anthropic = new Anthropic({ apiKey: '...' })
const res = await anthropic.messages.create({ messages, model: 'claude-sonnet-4-6', max_tokens: 1024 })

// After — one client, any provider, routes automatically
import { Rouva } from '@rouvanpm/rouva'
const rouva = new Rouva({ apiKey: 'rva_...' })
const res = await rouva.chat.completions.create({ messages })

Options

Gateway endpoint

Prefer Python or another language? Call the gateway directly over HTTP — no SDK required.

POST https://app.rouva.io/api/gateway/messages

Headers

Request body

Example — Python

import requests

response = requests.post(
    "https://app.rouva.io/api/gateway/messages",
    headers={
        "Authorization": "Bearer rva_your_key",
        "Content-Type": "application/json",
    },
    json={
        "messages": [{"role": "user", "content": "Hello!"}],
    }
)

print(response.json())

Supported models

Pass any of these model IDs in the model field to override routing. Make sure the relevant provider key is connected in your dashboard Settings.

Intelligent routing

When enabled, Rouva classifies each prompt and routes it to the cheapest model that can handle it well — without sacrificing quality. Toggle it in Gateway → Intelligent Routing.

Ready to get started?

Create your account, connect a provider, and make your first routed request in minutes.