Wenn deine App bereits mit OpenAIs API spricht, dauert der Wechsel zu Brievio etwa zehn Minuten — die meiste Zeit davon ist die Anmeldung. Du behältst dein SDK und deine Codebasis; du bekommst die echten Modelle auf zuverlässiger Infrastruktur mit ehrlicher Token-Abrechnung. Dieser Leitfaden führt dich durch die vier Integrationsvarianten, die die meisten Teams einsetzen, und die jeweils nötige Ein-Zeilen-Änderung.

Schritt 0 — Einen Key holen (2 Minuten)

Melde dich an unter brievio.com/app/signup. Du bekommst $2 Guthaben bei der Anmeldung; keine Karte nötig.
Gehe zu /app/keys und erstelle einen Key. Er beginnt mit sk-brievio-.
Setze die Umgebungsvariable: export BRIEVIO_API_KEY=sk-brievio-....

Schritt 1 — Dein SDK umstellen (1 Minute)

Python (openai-Paket)

migrate.py

# Vorher — direkt auf OpenAI zeigend
from openai import OpenAI
client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
)

# Nachher — auf Brievio zeigend. Alles andere bleibt gleich.
from openai import OpenAI
client = OpenAI(
    api_key=os.environ["BRIEVIO_API_KEY"],
    base_url="https://api.brievio.com/v1",
)

Node / TypeScript

migrate.mjs

// Vorher
import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

// Nachher
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: process.env.BRIEVIO_API_KEY,
  baseURL: "https://api.brievio.com/v1",
});

LangChain

LangChain nutzt intern denselben OpenAI-Client, daher ist die Änderung identisch. Die Modell-ID ist jetzt ein Brievio-Slug — siehe /models für die aktuelle Liste (probiere claude-sonnet-4-6, gemini-2.5-flash, claude-opus-4-7).

langchain_setup.py

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4-6",          # Modell gewechselt
    api_key=os.environ["BRIEVIO_API_KEY"],
    base_url="https://api.brievio.com/v1",
)

Vercel AI SDK

@ai-sdk/openai liest seine Base-URL und seinen API-Key standardmäßig aus Umgebungsvariablen. Setze diese, und du bist fertig — jeder Framework-Helper (streamText, generateObject, Retries, Tool-Routing) funktioniert unverändert.

vercel_ai.mjs

import { openai } from "@ai-sdk/openai";

// @ai-sdk/openai liest OPENAI_BASE_URL automatisch
process.env.OPENAI_BASE_URL = "https://api.brievio.com/v1";
process.env.OPENAI_API_KEY = process.env.BRIEVIO_API_KEY;

const model = openai("claude-sonnet-4-6");
// dann streamText / generateText / streamObject wie gewohnt nutzen

Anthropic-SDK (falls du bereits auf Claude bist)

Brievio stellt Anthropics native Messages-API unter /v1/messages ebenso bereit wie das OpenAI-Format — du musst also nicht das SDK wechseln.

anthropic_sdk.py

from anthropic import Anthropic

# Vorher — Anthropic-SDK gegen api.anthropic.com
client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

# Nachher — dasselbe SDK, gegen Brievio. Caching, Thinking, Tools laufen alle durch.
client = Anthropic(
    api_key=os.environ["BRIEVIO_API_KEY"],
    base_url="https://api.brievio.com",   # SDK hängt /v1/messages an
)

Schritt 2 — Die Wallet per Smoke-Test prüfen (1 Minute)

Bevor du Produktionscode anfasst, führe einen günstigen Test gegen claude-haiku-4-5 aus. Kommt der erfolgreich zurück, funktioniert dein Key, funktioniert die Abrechnung, ist die Routing-Schicht gesund.

smoke_test.py

# Günstiger, halbwegs deterministischer Smoke-Test zur Migrationsprüfung.
resp = client.chat.completions.create(
    model="claude-haiku-4-5",            # das günstigste Claude
    messages=[{"role": "user", "content": "ping"}],
    max_tokens=8,
    temperature=0,
)
assert resp.choices[0].message.content, "empty response"
print("ok — Brievio-Wallet funktioniert, Gesamtkosten ~$0,0001")

Schritt 3 — Traffic umziehen (5 Minuten)

Das sichere Muster: zwei Umgebungsvariablen in deiner App — AI_BASE_URL und AI_API_KEY — pro Umgebung ausgewählt. Produktion bleibt auf OpenAI; Staging wechselt zu Brievio. Nach 24 Stunden schaltest du die Produktion um.

Wenn du vor der Umstellung neugierig auf die Kostenwirkung bist, zeigt dir Brievios Dashboard die Kosten pro Call gegen den offiziellen Upstream-Tarif — so lässt sich das voraussichtliche monatliche Delta auf deinen echten Prompts leicht berechnen.

Was gleich bleibt

Dein SDK und deine Codebasis.
Streaming, Function Calling, Tool Use, Vision, strukturierte Outputs.
OpenAIs exakte Request- und Response-Schemas.
Die Fehlerstruktur (error.message / error.type / error.code).

Was sich zum Besseren ändert

Echtheit. Bei jedem Call das echte First-Party-Modell — voller Kontext, native Tools und Caching, keine stillen Downgrades oder umverpackten Proxys.
Preise. Jedes Modell ist rund 15% unter der offiziellen Liste des Anbieters bepreist, abgerechnet auf echten Token-Zahlen — siehe /pricing.
Modalität. Dasselbe SDK erreicht Claude (claude-opus-4-7), Gemini (gemini-2.5-pro), GPT-Image-2, Veo 3, Nano Banana — siehe /models.
Abrechnung. Stripe-native Wallet — Karten, Apple Pay, Google Pay, ACH, SEPA, Alipay, WeChat Pay. Eine prüfbare Rechnung.
Zuverlässigkeit. Überwachtes, automatisches Failover — wir leiten in dem Moment um, in dem ein Upstream nachlässt, typischerweise noch bevor deine Retry-Schleife auslöst.

Hinweise zum Unhappy Path

OpenAI-spezifische Endpunkte, die wir heute nicht abdecken: /v1/responses (nutze /v1/chat/completions), /v1/assistants (State auf deiner Seite; wir sind ein zustandsloses Gateway), /v1/realtime (geplant).
Einige Claude-spezifische Features — cache_control, erweitertes thinking — funktionieren am besten über den nativen /v1/messages-Endpunkt, nicht über das OpenAI-Format.

Hängst du fest? contact@brievio.com — ein Mensch antwortet innerhalb eines Werktags. Wenn du eine ernste Migration fährst, steigen wir mit dir in einen Call ein.

In 10 Minuten von OpenAI zu Brievio migrieren — Python, Node, LangChain, Vercel AI SDK