OpenAI-alternatief voor ontwikkelaars: API-sleutel en SDK-instelling
Drop-in uncensored OpenAI API-alternatief
Een openai-alternatief voor ontwikkelaars mag je hooguit een middag kosten, geen herschrijving. Deze werkt met de standaard OpenAI SDK's: je wijzigt de base URL, plakt een nieuwe sleutel en roept het model met de naam uncensored aan.

Belangrijkste punten
- Meld je aan, claim het $0,50 proeftegoed op de API-sleutelpagina en kopieer de sleutel. Voor de proefversie is geen kaart nodig.
- Stel base_url in op https://api.openaiapialternative.com/v1 en model op uncensored in elke OpenAI SDK.
- Streaming, function calling en JSON-modus volgen het OpenAI-formaat. De limieten zijn 8 gelijktijdige verzoeken en 300 per minuut met een volledige sleutel.
- Verwerk HTTP 429 met een korte backoff en respecteer de Retry-After-header.
Vijf stappen van nul tot een werkend verzoek
Als je een openai-alternatief voor ontwikkelaars wilt testen die je vandaag kunt uitproberen, is dit het hele pad. Het duurt ongeveer tien minuten.
- Maak een account aan met Google of met een e-mailadres en wachtwoord.
- Open de API-sleutelpagina en druk op de knop om het proeftegoed te claimen. Je krijgt $0,50, geldig voor 7 dagen, één per persoon, zonder creditcard.
- Kopieer de sleutel. Behandel hem als een wachtwoord en houd hem uit git.
- Stel de base URL in op
https://api.openaiapialternative.com/v1in je SDK of client. - Stuur een verzoek met het model ingesteld op
uncensored.
Alles anders, inclusief berichtformaat, streaming en toolaanroepen, is hetzelfde als het OpenAI chat-completions-formaat dat je al gebruikt. De service exposeert POST /v1/chat/completions en GET /v1/models. Niets meer, dus er is weinig te leren.
Python met de officiële SDK
Installeer het pakket met pip install openai. De client neemt de base URL en sleutel als constructorargumenten, dus er wordt geen globale status gewijzigd en je kunt een tweede client voor een andere provider in hetzelfde proces houden.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.openaiapialternative.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "Answer briefly and directly."},
{"role": "user", "content": "List three edge cases for a date parser."},
],
max_tokens=300,
)
print(resp.choices[0].message.content)
print(resp.usage)max_tokens is optioneel. Als je het weglaat, kan de voltooiing het resterende deel van de 100.000-token window gebruiken, dus stel een limiet in als je een voorspelbare kosten wilt.
Chatmodellen hebben geen eigen geheugen. Elk verzoek moet de geschiedenis dragen die je het model wilt laten zien, dus een multi-turn-assistent is gewoon een lijst die je blijft toevoegen:
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
history = [{"role": "system", "content": "You are a patient pair-programming partner."}]
while True:
user = input("you> ")
if not user:
break
history.append({"role": "user", "content": user})
r = client.chat.completions.create(model="uncensored", messages=history)
answer = r.choices[0].message.content
history.append({"role": "assistant", "content": answer})
print(answer)Inputtokens groeien met elke beurt, omdat de hele lijst elke keer wordt verzonden. Met een venster van 100.000 tokens heb je veel ruimte, maar je betaalt voor de geschiedenis bij elke aanroep, dus knip oude beurten of vat ze samen zodra de lijst lang wordt.
Node en curl
De Node SDK volgt hetzelfde patroon. Installeer met npm install openai en geef baseURL door.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.openaiapialternative.com/v1",
apiKey: process.env.UNCENSORED_API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about stack traces." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Voor een snelle controle vanuit de terminal, lijst je de modellen. Je zou één entry moeten zien met de ID uncensored.
# expect one entry with id "uncensored"
curl https://api.openaiapialternative.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_API_KEY"Een gestreamd verzoek houdt één van je gelijktijdige verzoeken vast tot de streaming eindigt, wat belangrijk is als een client een streaming verlaat zonder deze te sluiten. Sluit de verbinding aan je kant wanneer de gebruiker weg navigeert.
Editors, agents en andere clients
Veel ontwikkelaartools stellen je in staat de OpenAI base URL te overschrijven. Editors zoals Cursor hebben een modelscherm waar je een aangepaste OpenAI-compatible base URL en een sleutel kunt invoeren, en chat front-ends zoals SillyTavern stellen je in staat een aangepast OpenAI-compatible endpoint toe te voegen. Labels en menu-posities verschillen tussen versies, dus zoek naar een veld met een naam als "OpenAI base URL overschrijven" of "Aangepast endpoint".
Wat de tool ook is, je hebt dezelfde drie waarden nodig:
| Veld | Waarde |
|---|---|
| Basis-URL | https://api.openaiapialternative.com/v1 |
| API-sleutel | de sleutel van je account |
| Modelnaam | uncensored |
Als de tool aandringt op een lijst met bekende modelnamen, voeg uncensored toe als aangepast model. Als het /v1 toevoegt, geef dan het adres zonder de suffix, anders krijg je een dubbel pad en een not-found fout.
Tool calling en JSON-modus
Gestructureerde uitvoer is waar een alternatief meestal vastloopt, dus test het vroeg. Beide functies gebruiken het OpenAI-formaat. Stel voor JSON-modus response_format in en vermeld JSON in de prompt.
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": "Reply with a JSON object with keys title and tags."},
{"role": "user", "content": "Describe a short story about a lost lighthouse keeper."},
],
)
data = json.loads(resp.choices[0].message.content)
print(data["title"], data["tags"])Voor tools geef je een tools lijst met functieschema's door, lees tool_calls uit het antwoord, voer de functie zelf uit en stuur het resultaat terug als een bericht met role: "tool". Gestreamde antwoorden leveren tool_calls in stukken op, dus verzamel de argumentenstring voordat je het parset.
Modellen kunnen nog steeds af en toe foutieve JSON retourneren, welke provider je ook gebruikt. Wikkel het parsen in een try-blok en probeer het opnieuw met de foutmelding toegevoegd aan het gesprek.
Seedwaarden worden ook doorgegeven, dus door seed in te stellen met een vaste temperatuur heb je een manier om promptwijzigingen te vergelijken op dezelfde inputs. Verwacht geen byte-identieke output bij elke run, maar de verschillen worden veel kleiner.
Limieten, afhandeling van 429-fouten en kostenbeheer
Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. De proef-sleutel staat 2 en 60 toe. De body kan maximaal 8 MB zijn. Elk antwoord bevat X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency, plus X-Balance-USD voor je resterende tegoed.
Als je de limiet overschrijdt, krijg je HTTP 429. De foutcode vertelt je welke limiet: rate_limited betekent te veel verzoeken per minuut, en concurrency betekent te veel verzoeken tegelijk. Een tijdelijke overload retourneert ook 429, met een Retry-After: 5 header. De OpenAI SDK's proberen 429-antwoorden standaard opnieuw met backoff, en je kunt het aantal verhogen met max_retries op de client. Voor batchtaken houdt een semaphore van 8 je onder de limiet voor gelijktijdige verzoeken.
Voor budgettering werk je vanuit de prijs: $0,15 per 1M input tokens en $0,50 per 1M output tokens. Een taak die 4M input tokens verstuurt en 1M output tokens terugkrijgt kost 4 x $0,15 + 1 x $0,50 = $1,10. Mislukte of geweigerde verzoeken worden niet in rekening gebracht. De prijzenpagina geeft de top-up maten en bonussen weer.
Een korte retry-wrapper is genoeg als je geen SDK gebruikt die voor je retryt. Lees Retry-After wanneer aanwezig, val terug op een exponentiële vertraging, en geef op na een paar pogingen. Probeer niet opnieuw bij fouten die geen 429 of een serverfout zijn, omdat een malformed request elke keer op dezelfde manier zal falen.
Fouten die een uur kosten op de eerste dag
De meeste mislukkte eerste verzoeken komen door een korte lijst van oorzaken. Controleer deze voordat je de service verdenkt.
- Een verdubbeld pad. De basis-URL eindigt al op
/v1. Voeg er geen tweede toe en roep/chat/completionsniet zonder deze suffix aan. - De verkeerde modelnaam. Oude code bevat vaak een modelnaam van de leverancier. Vervang het door
uncensored, anders matcht de aanroep niets. - Een sleutel met spaties. Sleutels gekopieerd van een webpagina of terminal bevatten vaak een trailing newline. Verwijder het.
- Tests op een proefsleutel bij productie concurrency. De proefsleutel staat 2 gelijktijdige verzoeken en 60 per minuut toe, dus een loadtest met 20 threads zal bijna direct 429 retourneren met de code
concurrency. - Verwacht andere endpoints. Image, audio en embeddings calls zijn niet onderdeel van de service.
De tweede categorie is gedrag, geen configuratie. Een model zonder weigeringen volgt vreemde instructies letterlijker dan je verwacht. Als een antwoord ergens heen gaat waar je niet wilde, maak het systeem prompt strakker in plaats van de temperatuur. Als outputs repetitief zijn, verhoog temperature een beetje of voeg een frequentiestraf toe, beide worden doorgegeven.
Een laatste gewoonte die je vroeg kunt aannemen: sla de exacte request body van elke call die je verraste op. Als je het team om hulp vraagt op de support pagina, is de request ID plus die body een compleet bug rapport.
Voordat je levert
- Houd de sleutel op de server. Lever hem nooit in een browserbundel of een mobiele app.
- Log de
X-Request-Idheader bij elke aanroep. Het maakt ondersteuningsvragen beantwoordbaar. - Voeg je eigen input- en outputfiltering toe als eindgebruikers vrij kunnen typen. Het model zal niet weigeren, dus moderatie is aan jou om te definiëren.
- Houd een noodprovider in de config. Schakelen is een basis-URL-wijziging, dus een functie-vlag is genoeg.
- Onthoud de scope: alleen tekst, geen inbeddingen, geen afbeeldingen, geen fijnafstelling.
De documentatie heeft de volledige parameterlijst. Als iets vreemd gedraagt, vertelt de ondersteuningspagina je hoe je het team kunt bereiken.
Meer handleidingen
Vragen en antwoorden
Welke SDK's werken?
Elke OpenAI SDK of client waarmee je de base URL en sleutel kunt instellen. De officiële Python- en Node-bibliotheken werken, evenals gewone HTTP-aanroepen met curl.
Heb ik een kaart nodig om het te proberen?
Nee. Het proeftegoed van $0,50 claim je met één klik op de API-sleutelpagina na registratie en daarvoor heb je geen kaart nodig. Het is 7 dagen geldig, één per persoon.
Wat is de modelnaam?
De model-ID is uncensored. Roep GET /v1/models aan om dit te bevestigen met je eigen sleutel.
Hoe groot kan een verzoek zijn?
Het contextvenster is 100.000 tokens voor prompt plus voltooiing, en de maximale request body is 8 MB.
Je sleutel is nog maar één stap verwijderd
Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.