Wat is een OpenAI-compatibele API? Zo wissel je van aanbieder met één regel

Overstappen met één regel

De SDK's van OpenAI sturen verzoeken standaard naar OpenAI, maar je kunt een basis-URL instellen. Laat die naar een andere aanbieder verwijzen en gebruik de sleutel en modelnamen van die aanbieder; de rest van de code blijft hetzelfde.

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)

Hetzelfde werkt in TypeScript met baseURL, en in tools die vragen om een "OpenAI base URL" of "custom endpoint": OpenCode, Continue, Cline, Open WebUI en nog veel meer. In de integratiegidsen vind je de instellingen voor elke tool. Veel tools lezen ook de omgevingsvariabelen OPENAI_BASE_URL en OPENAI_API_KEY, waardoor je helemaal geen code hoeft aan te passen.

Basis-URL's van de belangrijkste aanbieders

De basis-URL eindigt meestal op /v1, en de SDK voegt daar /chat/completions aan toe. Sommige aanbieders gebruiken andere paden, dus neem die exact over:

De URL van elke aanbieder, met een model-ID en wat elk endpoint aanbiedt, staat in de lijst met OpenAI-compatibele basis-URL's, overgenomen uit de documentatie van elke aanbieder op 26 oktober 2026.

Wat blijft werken

• Berichten, systeemprompts en streaming.
• Toolaanroepen en gestructureerde output met een JSON-schema.
• Afbeeldingen en andere bestanden in het bericht, voor modellen die ze kunnen lezen.
• Het verbruiksblok, zodat het bijhouden van tokens hetzelfde werkt.

Wat je moet controleren voordat je overstapt

• Modelnamen. Elke aanbieder heeft eigen ID's; vraag ze op met GET /v1/models.
• Welke API's de aanbieder ondersteunt. Veel aanbieders ondersteunen Chat Completions, maar niet de Responses-, Realtime-, embeddings- of batch-API's van OpenAI. Zurelay ondersteunt Chat Completions, afbeeldingen, video en spraak, en de Messages API van Anthropic voor Claude.
• Extra parameters. Redeneerniveaus, cache-instellingen en samplinglimieten verschillen per model. Een goede aanbieder documenteert welke parameters elk model accepteert.
• Is het echt het beloofde model? Goedkope aanbieders bieden soms een ouder of goedkoper model aan onder een nieuwere naam. Je vindt vijf snelle controles in wat goedkope AI-API's echt verkopen.

Als overstappen niet lukt

• 404 Not Found. De basis-URL bevat het endpoint (.../v1/chat/completions) of mist het eigen pad van de aanbieder. Gebruik alleen de basis-URL.
• 401 Unauthorized. De sleutel hoort bij een andere aanbieder of, bij Model Studio van Alibaba, bij een andere regio.
• Model niet gevonden. Aanbieders gebruiken verschillende model-ID's voor hetzelfde model: claude-opus-5-5 bij Anthropic, anthropic/claude-opus-5 bij OpenRouter en de naam van je deployment bij Azure.
• 400 bij een parameter. Sommige aanbieders weigeren of negeren parameters die de API van OpenAI accepteert, zoals response_format bij de compatibiliteitslaag van Anthropic. Laat die parameter weg of stap over naar een aanbieder die hem ondersteunt.

Anthropic-compatibele API's

Claude Code en de SDK's van Anthropic gebruiken daarentegen de Messages API van Anthropic en lezen ANTHROPIC_BASE_URL uit. Verschillende aanbieders ondersteunen die API ook, waaronder DeepSeek, Moonshot, Z.ai, MiniMax en Zurelay; hun URL's eindigen nooit op /v1. Je vindt ze in de lijst, en prijzen van Claude Code vergelijkt wat Claude Code kost per abonnement en via de API.

Waarom zou je overstappen

Met één OpenAI-compatibele sleutel heb je toegang tot modellen van veel labs. Om Claude, GPT, Gemini en DeepSeek met je eigen prompts te vergelijken, hoef je dus alleen de modelnaam te wijzigen. Dat geldt ook als je overstapt naar een goedkoper model. Bekijk de modellen en prijzen.