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.


Begin met proeftegoed
E-mail en wachtwoord, de sleutel staat meteen op het scherm.
API-sleutel aanvragenWat 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:
- Herhaal 20 echte prompts uit je logs op het nieuwe endpoint.
- Vergelijk antwoorden, tokenaantallen en fouten met je huidige provider.
- Forceer een 429 en bevestig dat je opnieuw proberen werkt.
- Stuur 5% van het productieverkeer via een functievlag.
- 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.
Meer handleidingen
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.