NL ▾
API-sleutel aanvragen

OpenAI API-alternatieven: wat verandert er in je code

De meeste open ai api-alternatieven kopiëren het OpenAI-verzoekformaat, wat betekent dat overschakelen vaak een configuratiewijziging is in plaats van een herschrijving. Dit artikel laat precies zien wat er in de code verandert, wat kapot kan gaan, en waar een endpoint met één model dat OpenAI-compatibel is wel en niet een goede keuze is.

Bijgewerkt

Verschillende gekleurde kabels die op één standaard connectorpoort zijn aangesloten, wat uitwisselbare API-endpoints tonen
Vier platforms met een cloud, netwerkhub, GPU-doos en kubus verbonden met een centrale balans, voor het vergelijken van modelopties

Wat een alternatief te bieden heeft

Mensen zoeken naar open ai api-alternatieven om verschillende redenen: prijs, inhoudsregels, gegevensverwerking, regionale beschikbaarheid, of de wens om open-weight modellen te gebruiken. Wat de reden ook is, dezelfde test geldt. accepteert het alternatief de verzoekvorm die je al verstuurt, en retourneert het de antwoordvorm die je code al leest?

Als ja, veranderen je SDK-aanroepen niet. Als nee, schrijf je één keer een adapter, wat ook prima is, maar het is de hoofdkost van het wisselen. De rest van dit artikel gaat uit van het eerste geval, een OpenAI-compatibel endpoint.

De wijziging van drie regels

Met het officiële Python-pakket heeft de oorspronkelijke setup de standaard host en een OpenAI-sleutel. Voor een alternatief stel je drie dingen in: de base_url, de sleutel van de nieuwe provider en de modelnaam. Hier is de volledige versie voor dit endpoint:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",  # was the default host
    api_key=os.environ["NEW_PROVIDER_KEY"],            # was your OpenAI key
)

r = client.chat.completions.create(
    model="uncensored",                                 # was an OpenAI model name
    messages=[{"role": "user", "content": "Pitch me a plot twist for a mystery."}],
)
print(r.choices[0].message.content)

Hetzelfde werkt in Node door baseURL door te geven aan de constructor, in LangChain-style wrappers via hun base URL-optie, en in tools die een aangepast endpointveld hebben. In curl pas je de host en de header aan:

curl https://api.uncensoredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $NEW_PROVIDER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

Wat er na het wisselen kapot kan gaan

Modelnamen

Model-ID's behoren tot de provider. Alles dat een OpenAI-modelnaam hardcodeert, moet worden bijgewerkt. Zet de naam in de configuratie.

Parameters

Kernopties zoals temperature, top_p, stop en max_tokens worden overgenomen. Anderen, zoals logprobs of bepaalde response-format-opties, zijn afhankelijk van de provider. Op dit endpoint worden temperature, top_p, stop, seed en de penalties doorgegeven, en werkt JSON-modus met response_format: {"type":"json_object"}.

Kwaliteit van function calling

Het draadformaat is gedeeld, maar hoe goed een model tools kiest en argumenten invult, verschilt. Laat je echte toolschemas door het nieuwe model lopen en valideer argumenten in je code.

Contextlengte en truncatie

Een wijziging van het contextvenster verandert hoeveel geschiedenis je kunt versturen. Hier is het venster 100.000 tokens voor prompt plus completion.

Fouten en limits

Providers gebruiken verschillende limieten en codes. Deze retourneert HTTP 429 met rate_limited voor verzoeken per minuut en concurrency voor te veel in één keer, en een 429 met Retry-After: 5 bij tijdelijke overbelasting. Je retry-logica moet 429-fouten van elke provider afhandelen.

Gedrag

De grootste verandering is niet technisch. Modellen verschillen in toon, formatteringsgewoonten en wat ze weigeren. Test met je echte prompts, niet met demo's.

Waar een endpoint met één model past

Deze service is een OpenAI-compatibele tekst-API met één open-weight model, gedraaid door een onafhankelijke provider en afgestemd op antwoorden zonder inhoudsweigeringen voor wettelijk volwassen gebruik. Het is niet de officiële API van OpenAI, Meta, Mistral, Qwen, DeepSeek, xAI, Google, Anthropic of een andere leverancier, en het is geen router tussen leveranciers. De model-ID is uncensored.

Het past goed bij deze taken: fictie- en roleplay-tools voor volwassenen, companion-apps, schrijfassistenten die niet midden in een scène moeten stoppen, en backends waar stabiel gedrag bij volwassen thema's belangrijker is dan kiezen tussen veel modellen. Het is ook geschikt voor ontwikkelaars die een eenvoudige prijs per token willen en prompts die niet worden gebruikt voor training.

Waar het niet past

Wees eerlijk over de limieten voordat je verkeer verplaatst:

  • Alleen één model. Je kunt geen kleiner, goedkoper model kiezen voor eenvoudige taken of een groter model voor moeilijke taken. Als je afhankelijk bent van modelrouting, heb je een ander platform nodig.
  • Alleen tekst. Geen afbeeldings-, audio- of videogeneratie, geen embeddings en geen fine-tuning. Een retrieval-app die embeddings nodig heeft, moet ze elders krijgen.
  • Geen vlaggenschip van een leverancier. Als je een specifiek benoemd model nodig hebt voor compliance of benchmarks, gebruik dan die leverancier.
  • Harde limiet. Geen seksuele inhoud met minderjarigen, nooit.

Veel teams draaien twee endpoints: een hoofdprovider en een tweede voor inhoud die de eerste weigert. Omdat beide hetzelfde formaat delen, is dat een klein beetje code, een config-switch en een fallback bij bepaalde fouten.

Kosten: hoe vergelijken

Controleer de huidige prijzen van elke provider en converteer ze naar je verzoekvorm. Voor dit endpoint kosten input $0,15 per 1M tokens en output $0,50 per 1M. Voorbeeld: 3.000 input en 500 output tokens kosten $0,00045 + $0,00025 = $0,0007 per aanroep, dus 10.000 aanroepen per maand kosten $7. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, er is geen abonnement en tegoed vervalt nooit.

Opwaarderingen lopen van $20 tot $500, per crypto (USDT op TRC20, USDC op Base), met een bonus van +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Voor een tabel over hoe verschillende modelkeuzes zich verhouden, zie AI-modellen en prijzen vergelijken. De prijzenpagina heeft de volledige lijst.

Een fallbackpatroon voor twee endpoints

Als je een tweede endpoint wilt voor inhoud die je hoofdprovider weigert, houd beide clients aan en kies per verzoek. Deze schets stuurt een verzoek eerst naar de hoofdprovider en probeert de tweede als het antwoord een door jou gedefinieerd weigeringsteken is, of als een aanroep faalt:

import os
from openai import OpenAI

main = OpenAI(api_key=os.environ["MAIN_KEY"])
second = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",
    api_key=os.environ["NEW_PROVIDER_KEY"],
)

def ask(messages, main_model, use_second_first=False):
    order = [(second, "uncensored"), (main, main_model)] if use_second_first else [(main, main_model), (second, "uncensored")]
    last = None
    for client, model in order:
        try:
            r = client.chat.completions.create(model=model, messages=messages)
            return r.choices[0].message.content
        except Exception as err:
            last = err
    raise last

Routeer op inhoudstype waar je dat kunt. Een functie voor het schrijven van verhalen kan rechtstreeks naar het tweede endpoint gaan met use_second_first=True, terwijl een facturatieassistent op de hoofdprovider blijft. Dat voorkomt dat je eerst betaalt voor een mislukte aanroep en houdt het gedrag voorspelbaar voor gebruikers.

Een veilige manier om te testen

Verplaats niet al het verkeer in één keer. Claim de proefversie van $0,50 op de API-sleutelpagina, die geen kaart vereist en 7 dagen duurt, en voer vervolgens deze stappen uit:

  1. Herhaal 20 echte prompts uit je logs op het nieuwe endpoint.
  2. Vergelijk antwoorden, tokenaantallen en fouten met je huidige provider.
  3. Forceer een 429 en bevestig dat je opnieuw proberen werkt.
  4. Stuur 5% van het productieverkeer via een functievlag.
  5. Houd de X-Balance-USD-header en je foutenpercentage een paar dagen in de gaten voordat je het verbreedt.

De documentatie behandelt de methoden, en de ongecensureerde coderings-LLM laat één ontwikkelaarsgebruik in detail zien.

01

Vragen en antwoorden

Kan ik de OpenAI SDK met een andere provider gebruiken?

Ja, als de provider OpenAI-compatibel is. Stel de base URL, de sleutel en de modelnaam in op de waarden van de nieuwe provider.

Is dit de API van OpenAI?

Nee. Het is een onafhankelijke OpenAI-compatible endpoint die één open-weight model draait, en het is geen officiële API van OpenAI of een andere leverancier.

Worden streaming en tools ondersteund?

Ja. Streaming werkt via SSE met stream: true, en function calling gebruikt de standaard tools en het tool_calls-formaat.

Wat moet ik controleren voordat ik overschakel?

Modelnamen, ondersteunde parameters, gedrag van function calling, contextlimieten, foutafhandeling voor 429 en bovenal hoe het model reageert op je echte prompts.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragen