Hoe gebruik je een OpenAI-compatibele API in 5 stappen
Een OpenAI-stijl API gebruiken vereist vijf stappen: haal een sleutel op, installeer een SDK, wijs deze naar de juiste base URL, kies een model en stuur berichten. Hieronder vind je elke stap met code die je kunt plakken.

Belangrijkste punten
- Elke OpenAI SDK werkt hier zodra je de base URL wijzigt naar https://api.uncensoredaiapis.com/v1 en je eigen sleutel gebruikt.
- De model-ID is uncensored; de belangrijkste routes zijn POST /v1/chat/completions en GET /v1/models.
- Streaming, JSON-modus en toolaanroepen gebruiken dezelfde parameters als de officiële API.
- Prijzen zijn $0,15 per 1M inputtokens en $0,50 per 1M outputtokens, en je kunt beginnen met $0,50 aan proeftegoed.
De korte versie
Als je wilt weten hoe je openai api-aanroepen kunt gebruiken met een service die niet OpenAI is, is het antwoord dat het verzoekformaat een gedeelde conventie is. Een client die dit spreekt heeft drie waarden nodig: waar verzoeken naartoe moeten (de base URL), wie je bent (de sleutel) en welk model moet draaien. Verander die drie en dezelfde code werkt. Deze site volgt die conventie, dus de standaard OpenAI Python- en Node-pakketten, en gewone curl, werken allemaal tegen deze service.
Wees duidelijk over wat dat wel en niet betekent. Compatibel betekent dat de interface overeenkomt. Het betekent niet dat dit de officiële OpenAI-service is of dat het OpenAI-modellen draait. De backend is één open-weight model, beheerd door een onafhankelijke provider en afgestemd op antwoorden zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik, en je selecteert het met de model-ID uncensored. Het verwerkt alleen tekst: geen afbeeldingen, audio, embeddings of fine-tuning.
De vijf onderstaande stappen duren ongeveer tien minuten. Als je liever kant-en-klare fragmenten in meerdere talen leest, bekijk dan de codevoorbeelden-pagina.
Stap 1: haal een sleutel
Meld je aan met Google, of met e-mail en wachtwoord, en open de API-sleutelpagina. Nieuwe gebruikers kunnen $0,50 aan proeftegoed met één klik claimen. Het is 7 dagen geldig, beperkt tot één per persoon, en vereist geen kaart. Kopieer de sleutel en sla deze op als een omgevingsvariabele in plaats van deze in de code te plakken:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"De proefsleutel is beperkt tot 2 gelijktijdige verzoeken en 60 verzoeken per minuut. Een gefinancierde sleutel staat 8 gelijktijdige en 300 per minuut toe. De details van wat de proefversie omvat, staan in de FAQ voor gratis proefversies.
Stap 2: installeer een SDK en stuur het eerste verzoek
Installeer het officiële pakket voor je taal. Beide zijn dezelfde bibliotheken die je zou gebruiken voor elke OpenAI-stijl service:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiNu een eerste aanroep in Python. Het enige verschil met de standaardconfiguratie is het argument base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)En dezelfde call in Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Stap 3: begrijp de messages-array
Chatmodellen onthouden niets tussen aanroepen. Elk verzoek bevat het hele gesprek als een lijst van berichten, en elk bericht heeft een rol.
systemstelt gedrag en stijl in. Plaats hier het persona, formaatregels en beperkingen.userbevat wat de persoon vroeg.assistantbevat de eerdere antwoorden van het model. Je voegt deze zelf toe wanneer je een gesprek voortzet.toolbevat het resultaat van een functieaanroep, hieronder behandeld.
Om een gesprek voort te zetten, voeg je het antwoord van de assistent en de volgende bericht van de gebruiker toe aan dezelfde lijst en stuur je alles opnieuw. Dit is waarom lange gesprekken meer kosten: elke call betaalt voor de volledige geschiedenis als input-tokens. Het venster houdt in totaal 100.000 tokens vast, prompt en voltooiing samen, dus het inkorten van oude beurt is een normaal onderdeel van het bouwen van een chat-app.
Nuttige samplingvelden worden doorgegeven: temperature, top_p, stop, seed en de frequentie- en aanwezigheidsstraffen. max_tokens is optioneel. Stel het in wanneer je de lengte en kosten van het antwoord wilt beperken.
Stap 4: streaming, JSON-modus en tools
Streaming
Voeg stream: true toe om tokens te ontvangen als server-verzonden gebeurtenissen. Het laat interfaces snel aanvoelen, omdat tekst verschijnt terwijl het model nog aan het schrijven is, en het gebruik wordt aan het einde van de stream gerapporteerd.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}JSON-modus
Gebruik response_format: {"type": "json_object"} wanneer je code het antwoord verwerkt. Beschrijf ook de gewenste sleutels in de prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Function calling
Geef een tools-lijst met funtieschema's door, en optioneel tool_choice. Als het model een functie wil uitvoeren, bevat het antwoord tool_calls. Je voert de functie uit in je eigen code en stuurt de output terug als een bericht met de rol tool. Tool calls streamen ook. Dit is de bouwsteen voor agents; de use cases-pagina laat zien waar dat zich uitbetaalt.
Stap 5: ken de limieten, kosten en fouten
Bij een overschrijding retourneert de API HTTP 429. De foutcode is rate_limited voor te veel verzoeken per minuut en concurrency voor te veel in één keer. Een tijdelijke overbelasting geeft ook een 429, met een Retry-After: 5-header. Een gestreamd verzoek houdt zijn concurrency-slot vast tot de stream eindigt, dus sluit streams die je niet langer leest. De body-limiet is 8 MB. Elk antwoord bevat X-Request-Id- en X-Balance-USD-headers, en de eerste is wat je citeert ter ondersteuning.
Kosten zijn eenvoudig. Een chataanroep met 3.000 inputtokens en 700 outputtokens kost 3.000 keer $0,15 per miljoen, wat $0,00045 is, plus 700 keer $0,50 per miljoen, wat $0,00035 is, dus $0,0008 in totaal. Duizend dergelijke aanroepen kosten $0,80. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, en tegoed verloopt nooit. De prijzenpagina geeft opwaarderingen van $20 tot $500 met +5% vanaf $50, +10% vanaf $100 en +15% vanaf $200. Je kunt betalen met crypto (USDT op TRC20, USDC op Base).
Hoe dit verschilt van de officiële API
Drie verschillen zijn het overwegen waard. Ten eerste de modelnaam: gebruik uncensored, geen OpenAI-modelnaam. Ten tweede het bereik: je krijgt alleen chatcompleties en de modellenlijst, dus functies zoals beeldgeneratie, spraak, embeddings en fine-tuning zijn hier niet beschikbaar. Ten derde gedrag: het model is afgestemd om wettelijke volwassen verzoeken niet te weigeren, dus de output kan verschillen van een sterk gefilterde assistent. Eén regel verandert nooit: geen seksuele inhoud met minderjarigen.
Een paar gewoontes helpen op de eerste dag. Houd de sleutel in een omgevingsvariabele, log de X-Request-Id van elke call, en stel max_tokens in terwijl je experimenteert, zodat een uit de hand gelopen antwoord niet meer kan uitgeven dan je van plan was. Als je een chat-interface bouwt, stream dan het antwoord en knip oude beurt in als de geschiedenis groeit. Als je een pipeline bouwt die output parseert, gebruik dan JSON-modus en bewaak de parsing nog steeds, omdat een antwoord dat afgesneden is bij de tokenlimiet geen geldige JSON is. En als twee onderdelen van je programma tegelijk de API aanroepen, tel ze dan mee tegen de 8 gelijktijdige verzoeken die een volledige sleutel toestaat.
Vergeet niet de kosten van testen. Een paar tientallen experimenten met korte prompts kosten veruit minder dan een cent in totaal, dus het $0,50 proeftegoed gaat een lange weg terwijl je het verzoekformaat leert.
Als je een bestaande app verplaatst, behandelt de migratiegids de wijzigingen in volgorde. Prompts die hier worden verzonden, worden niet gebruikt voor training. Voor de meeste apps is de migratie de drie waarden van het begin van deze pagina en een modelnaam.
Meer handleidingen
Vragen en antwoorden
Heb je de officiële OpenAI SDK nodig?
Je kunt het gebruiken, en het is de makkelijkste route. Elke OpenAI-compatibele client of gewone HTTP werkt ook, zolang het een aangepaste base URL ondersteunt.
Welke modelnaam stuur ik?
Stuur uncensored. De base URL is https://api.uncensoredaiapis.com/v1.
Is dit de officiële OpenAI API?
Nee. Het volgt hetzelfde verzoekformaat, maar het model is een open-weight model dat wordt beheerd door een onafhankelijke provider, en de service is gescheiden van OpenAI.
Hoeveel kost een verzoek?
Inputtokens kosten $0,15 per 1M en outputtokens $0,50 per 1M. Een verzoek met 3.000 input- en 700 outputtokens kost ongeveer $0,0008.
Kan ik het uitproberen voordat ik betaal?
Ja. Na het registreren kun je met één klik $0,50 aan proeftegoed claimen. Het is 7 dagen geldig en vereist geen kaart.
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.