Dokumentation
Alles, was Sie brauchen.
Kurz und direkt: API, CLI und Abrechnung an einem Ort.
Schnellstart
- 1
Konto eröffnen
Registrieren und E-Mail bestätigen.
- 2
Guthaben aufladen
Ab 2 €, kein Abo. Neue Konten starten bei 0.
- 3
API-Key erstellen
Unter Entwickler. Der Key (orv_…) wird nur einmal angezeigt.
- 4
Loslegen
Per API, mit der CLI oder in Tools wie opencode.
API
Die API ist OpenAI-kompatibel. Jede Bibliothek, die OpenAI spricht, funktioniert mit geänderter Base URL.
Base URL
https://orrevan.com/api/v1
Authentifizierung
Header Authorization: Bearer orv_… bei jeder Anfrage. Key nie im Browser oder in öffentlichem Code verwenden.
Endpunkte
- GET /models
- Alle Modelle mit Preisen und Fähigkeiten. Ohne Key abrufbar.
- POST /chat/completions
- Chat-Antwort, optional gestreamt.
- GET /me
- Konto und Guthaben zum Key.
- POST /web/search
- Websuche, kostet pro Suche mit Ergebnissen.
curl
curl https://orrevan.com/api/v1/chat/completions \
-H "Authorization: Bearer $ORREVAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "orrevan/abliterated-model",
"messages": [{"role": "user", "content": "Hi"}]}'Python (openai)
from openai import OpenAI
client = OpenAI(base_url="https://orrevan.com/api/v1", api_key="orv_...")
r = client.chat.completions.create(
model="orrevan/abliterated-model",
messages=[{"role": "user", "content": "Hi"}],
)
print(r.choices[0].message.content)Node.js (openai)
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://orrevan.com/api/v1", apiKey: process.env.ORREVAN_API_KEY });
const r = await client.chat.completions.create({
model: "orrevan/abliterated-model",
messages: [{ role: "user", content: "Hi" }],
});
console.log(r.choices[0].message.content);Modelle
Modell-IDs beginnen mit orrevan/. Preise in USD pro 1 Mio. Tokens, live aus dem System.
| ID | Eingabe | Ausgabe | Bilder |
|---|---|---|---|
| orrevan/abliterated-modelAbliterated Model | $1.50 | $4.50 | ja |
| orrevan/abliterated-model-large-v2Abliterated Large V2 | $4.50 | $7.50 | nein |
| orrevan/abliterated-model-largeAbliterated Large | $4.50 | $7.50 | nein |
| orrevan/abliterated-model-large-flashAbliterated Large Flash | $1.50 | $3.00 | ja |
| orrevan/deepseek-v4.1-flash-uncDeepSeek V4.1 Flash Uncensored | $0.60 | $2.10 | ja |
| orrevan/glm53-flash-uncGLM 5.3 Flash Uncensored | $0.30 | $1.20 | ja |
| orrevan/mimo-v26-flash-uncMiMo V2.6 Flash Uncensored | $0.69 | $2.25 | ja |
| orrevan/qwen38-oblQwen3.8 27B Obliterated | $0.32 | $2.21 | ja |
| orrevan/qwen38-uncQwen3.8 27B Uncensored | $0.73 | $3.26 | ja |
| orrevan/mimo-v26-flash-ablMiMo V2.6 Flash Abliterated | $0.75 | $2.25 | ja |
Alle Modelle sind unzensiert. Bilder als base64 data URL (PNG, JPEG, WebP) im Feld image_url.
Streaming
Mit "stream": true kommt die Antwort als Server-Sent Events, Stück für Stück. Mit stream_options.include_usage erhalten Sie am Ende die Token-Zahlen.
stream = client.chat.completions.create(
model="orrevan/abliterated-model",
messages=[{"role": "user", "content": "Hi"}],
stream=True,
stream_options={"include_usage": True},
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")Tools und Extras
- tools, tool_choice
- Function Calling im OpenAI-Format, bis 128 Tools pro Anfrage.
- reasoning_effort
- Denktiefe: none, low, medium, high oder max, je nach Modell (siehe /models, capabilities.reasoning).
- response_format
- JSON-Ausgabe, wenn das Modell es unterstützt.
- web_search: true
- Orrevan-Extra: sucht vor der Antwort im Web. Kleine Gebühr pro Suche.
- temperature, top_p, max_tokens, stop, seed
- Wie bei OpenAI.
{"model": "orrevan/abliterated-model",
"messages": [{"role": "user", "content": "Weather in Tallinn?"}],
"tools": [{"type": "function", "function": {
"name": "get_weather",
"parameters": {"type": "object",
"properties": {"city": {"type": "string"}}, "required": ["city"]}}}],
"reasoning_effort": "low"}Fehlercodes
- 400
- Ungültige Anfrage, z. B. falsches JSON oder unbekanntes Modell.
- 401
- Key fehlt, ist falsch, widerrufen oder abgelaufen.
- 402
- Guthaben aufgebraucht. Aufladen unter Guthaben.
- 413
- Anfrage zu groß.
- 429
- Zu viele Anfragen, zu viele parallel oder Tageslimit des Keys erreicht.
- 502, 503, 504
- Modell gerade nicht erreichbar. Später erneut versuchen, es wird nichts berechnet.
CLI
Uncensored Coding-Agent im Terminal. Braucht Node.js 20 oder neuer.
npm i -g orrevan orrevan login orrevan
Befehle
- orrevan
- Sitzung im aktuellen Ordner
- orrevan "aufgabe"
- Mit erster Aufgabe starten
- orrevan -p "frage"
- Einmal antworten und beenden
- orrevan login / logout
- Key speichern oder entfernen
- orrevan models
- Modelle und Preise
- orrevan balance
- Guthaben
- orrevan whoami
- Konto, Modell, Version
- orrevan update
- Neueste Version installieren
- orrevan config set model <id>
- Standardmodell setzen
- orrevan mcp add <name> -- <cmd>
- MCP-Server hinzufügen
Optionen
- -m, --model <id>
- Modell für diese Sitzung
- -c, --continue
- Letzte Unterhaltung fortsetzen
- -r, --resume
- Frühere Unterhaltung wählen
- --scout
- Nur lesen und planen
- --auto
- Ohne Rückfrage ausführen (Vorsicht)
- --web
- Websuche erlauben
- --reasoning <stufe>
- auto, off, low, medium, high, max
- --tools <modus>
- auto, native oder text
Umgebungsvariablen
- ORREVAN_API_KEY
- Key statt orrevan login
- ORREVAN_MODEL
- Standardmodell
- ORREVAN_BASE_URL
- Andere API-Adresse
- ORREVAN_NO_UPDATE_CHECK=1
- Kein Update-Hinweis
opencode
opencode lässt sich mit Orrevan als Anbieter nutzen. Datei ~/.config/opencode/opencode.json anlegen, Key als Umgebungsvariable setzen, opencode starten.
Key setzen (z. B. in ~/.bashrc oder ~/.zshrc)
export ORREVAN_API_KEY="orv_..."
Konfiguration
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"orrevan": {
"npm": "@ai-sdk/openai-compatible",
"name": "Orrevan",
"options": {
"baseURL": "https://orrevan.com/api/v1",
"apiKey": "{env:ORREVAN_API_KEY}"
},
"models": {
"orrevan/abliterated-model": { "name": "Abliterated Model" }
}
}
},
"model": "orrevan/orrevan/abliterated-model"
}Weitere Modelle im Block models ergänzen. Alle IDs liefert GET /models.
Limits und Key-Ablauf
- 60 Anfragen pro Minute
- Pro Key, auf Wunsch niedriger einstellbar.
- 3 parallele Anfragen
- Pro Konto, über alle Keys.
- Tageslimit
- Standard 50 $ pro Key und Tag (0,50 $ bis 1.000 $). Zurückgesetzt um Mitternacht UTC.
- Ablauf
- Jeder Key läuft ab, nach 1, 3, 6 oder 12 Monaten. Kein „nie“. Erinnerung per E-Mail 7 Tage vorher.
- Erneuern
- Key rotieren erzeugt einen neuen Key mit gleichen Limits, der alte wird ungültig.
- Warnungen
- E-Mail bei ungewöhnlichem Verbrauch, neuen IPs und erreichtem Tageslimit.
Preise und Guthaben
- Pay-as-you-go
- Sie zahlen pro Token. Kein Abo, keine Grundgebühr.
- Aufladen
- 2, 5, 10 oder 25, oder frei zwischen 2 und 500, in EUR oder USD.
- Ein Guthaben
- Web-Chat, API und CLI nutzen dasselbe Guthaben.
- Fehler kosten nichts
- Schlägt eine Anfrage fehl, wird nichts berechnet.
Datenschutz
- Kein Training mit Ihren Daten. Orrevan verwendet Ihre Eingaben und Antworten nicht zum Training von KI-Modellen.
- API-Anfragen werden nicht gespeichert. Gespeichert werden nur Abrechnungsdaten (Modell, Tokens, Kosten).
- Chats im Web werden mit AES-256-GCM verschlüsselt gespeichert und lassen sich jederzeit löschen.
- Die CLI speichert Unterhaltungen nur auf Ihrem Rechner.