Was ist eine OpenAI-kompatible API? Anbieter mit einer Zeile wechseln

Wechsel mit einer Zeile

Die OpenAI-SDKs senden Anfragen standardmäßig an OpenAI, lassen sich aber auf eine andere Base-URL einstellen. Gib die URL eines anderen Anbieters sowie dessen Key und Modellnamen an; der Rest des Codes bleibt gleich.

from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",  # the only line that changes
    api_key="YOUR_ZURELAY_KEY",
)
reply = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

Das funktioniert auch in TypeScript mit baseURL und in Tools, die nach einer „OpenAI base URL“ oder einem „custom endpoint“ fragen: OpenCode, Continue, Cline, Open WebUI und viele mehr. Die Integrationsanleitungen zeigen die Einstellungen für jedes Tool. Viele Tools lesen auch die Umgebungsvariablen OPENAI_BASE_URL und OPENAI_API_KEY. Dann brauchst du gar keinen Code zu ändern.

Base-URLs der wichtigsten Anbieter

Die Base-URL endet normalerweise auf /v1, und das SDK hängt /chat/completions an. Einige Anbieter verwenden andere Pfade. Übernimm sie deshalb genau:

Die URL jedes Anbieters, eine Modell-ID und die Funktionen der einzelnen Endpunkte findest du in der Liste OpenAI-kompatibler Base-URLs, zusammengestellt anhand der Anbieterdokumentation vom 26. Oktober 2026.

Was weiterhin funktioniert

• Nachrichten, System-Prompts und Streaming.
• Tool-Aufrufe und strukturierte Ausgaben mit einem JSON-Schema.
• Bilder und andere Dateien in der Nachricht, sofern das Modell sie verarbeiten kann.
• Der Nutzungsdatenblock, damit die Token-Abrechnung genauso funktioniert.

Was du vor dem Wechsel prüfen solltest

• Modellnamen. Jeder Anbieter hat eigene IDs; liste sie mit GET /v1/models auf.
• Unterstützte APIs. Viele Anbieter unterstützen Chat Completions, aber nicht OpenAI's Responses, Realtime, Embeddings oder Batch-APIs. Zurelay unterstützt Chat Completions, Bilder, Video und Sprache sowie Anthropic's Messages API für Claude.
• Zusätzliche Parameter. Reasoning-Stufen, Cache-Einstellungen und Sampling-Limits unterscheiden sich je nach Modell. Ein guter Anbieter dokumentiert, welche Parameter jedes Modell unterstützt.
• Ist es wirklich das angegebene Modell? Günstige Anbieter liefern unter einem neuen Namen manchmal ein älteres oder günstigeres Modell. Fünf schnelle Checks findest du unter was günstige KI-APIs wirklich verkaufen.

Wenn der Wechsel fehlschlägt

• 404 Not Found. Die Basis-URL enthält bereits den Endpunkt (.../v1/chat/completions) oder der anbieterspezifische Pfad fehlt. Verwende nur die Basis-URL.
• 401 Unauthorized. Der Schlüssel gehört zu einem anderen Anbieter oder, bei Alibaba's Model Studio, zu einer anderen Region.
• Modell nicht gefunden. Die Modell-IDs unterscheiden sich je nach Anbieter, selbst für dasselbe Modell: claude-opus-5-5 bei Anthropic, anthropic/claude-opus-5 auf OpenRouter, der Name deines Deployments auf Azure.
• 400 bei einem Parameter. Manche Anbieter lehnen Parameter ab oder ignorieren sie, obwohl OpenAI's API sie unterstützt, etwa response_format bei Anthropic's Kompatibilitätsschicht. Lass den Parameter weg oder wechsle zu einem Anbieter, der ihn unterstützt.

Anthropic-kompatible APIs

Claude Code und die Anthropic SDKs nutzen stattdessen Anthropic's Messages API und lesen ANTHROPIC_BASE_URL. Auch mehrere andere Anbieter unterstützen diese API, darunter DeepSeek, Moonshot, Z.ai, MiniMax und Zurelay; ihre URLs enden nie auf /v1. Du findest sie in der Liste. Unter Preise für Claude Code siehst du, was Claude Code mit den verschiedenen Tarifen und über die API kostet.

Warum überhaupt wechseln?

Mit einem einzigen OpenAI-kompatiblen Schlüssel erreichst du Modelle vieler Labs. Um Claude, GPT, Gemini und DeepSeek mit deinen eigenen Prompts zu vergleichen oder zu einem günstigeren Modell zu wechseln, musst du nur den Modellnamen ändern. Sieh dir die Modelle und Preise an.