OpenAI-stijl API met cURL en een Bearer-token
Om een OpenAI-stijl API vanaf de commandoregel aan te roepen, stuur je een HTTP POST met een Authorization header die je token bevat. Deze pagina biedt werkende cURL-commando's voor elke functie van deze API, en de checks die je moet uitvoeren als er iets misgaat.
Bijgewerkt

Belangrijkste punten
- De token gaat in de header Authorization: Bearer YOUR_KEY, en de model-id is uncensored.
- Er zijn twee endpoints: GET /v1/models en POST /v1/chat/completions.
- Voeg -N en stream true toe om te zien hoe tokens via server-sent events aankomen.
- Lees X-Balance-USD en de rate limit headers met curl -i; een 429 betekent wachten en opnieuw proberen.
Het minimale verzoek
Hier is de kortste manier om open ai api curl met token tegen deze service uit te voeren. Plaats de sleutel in een omgevingsvariabele zodat deze niet in je shellgeschiedenis terechtkomt, en stuur dan een chatbericht:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
Het antwoord is JSON in de OpenAI chat completion-vorm. Het antwoord staat bij choices[0].message.content, en een usage object rapporteert prompt en output-tokens. Elk onderdeel van het commando heeft een taak:
Authorization: Bearer ...bevat de token. "Bearer" is de scheme-naam; wie de token bezit, wordt beschouwd als de eigenaar, vandaar dat je deze buiten publieke repositories houdt.Content-Type: application/jsonvertelt de server hoe het verzoeklichaam gelezen moet worden. Zonder deze header faalt het verzoek vaak met een body parsing error.modelmoetuncensoredzijn, het enige model dat deze API aanbiedt.messagesis een lijst van objecten met eenrole(system, user, assistant of tool) encontent.
Om een sleutel te krijgen, meld je aan met Google of e-mail en wachtwoord en ga naar de API-sleutelpagina. Nieuwe gebruikers kunnen daar met één klik $0.50 aan gratis proeftegoed claimen: geen creditcard nodig, geldig voor 7 dagen, één per persoon.
Controleer de sleutel met GET /v1/models
Voordat je een lang verzoek debugt, bevestig dan eerst dat de API-sleutel werkt met de goedkoopste aanroep die beschikbaar is. Modellen opsommen kost niets en toont of de URL, de header en de API-sleutel allemaal correct zijn.
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
Een goed antwoord is een JSON-lijst die uncensored bevat. Als je jq hebt geïnstalleerd, pipe je de output om alleen de IDs te extraheren:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
Als er niets nuttigs terugkomt, werk dan de onderstaande lijst in volgorde af, omdat de oorzaken zijn gesorteerd op frequentie:
- De variabele is leeg. Voer
echo "${UF_KEY:0:6}"uit om de eerste karakters te zien zonder de hele sleutel af te drukken. - De header is verkeerd gespeld, of "Bearer" ontbreekt voor de sleutel.
- Curly quotes uit een document of chatclient hebben rechte quotes in het commando vervangen.
- De base URL is verkeerd. Het is
https://api.unfilteredaimodels.com/v1, metapi.ervoor en/v1erachter. - De sleutel werd gekopieerd met een spatie of newline aan het eind.
Lees de response headers
Voeg -i toe om headers in de output op te nemen, of -D - om ze af te drukken terwijl de body schoon blijft:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
Vier response headers zijn het vermelden waard:
| Header | Betekenis |
|---|---|
X-Request-Id | Identificatie voor dit verzoek. Noem het als je contact opneemt met de ondersteuning. |
X-Balance-USD | Je resterende prepaid tegoed. |
X-RateLimit-Limit-Requests | Verzoeken per minuut toegestaan voor je API-sleutel. |
X-RateLimit-Limit-Concurrency | Gelijktijdige verzoeken toegestaan voor je key. |
De limieten zijn 300 verzoeken per minuut en 8 gelijktijdige verzoeken voor een volledige API-sleutel, en 60 per minuut en 2 gelijktijdig voor een proef-API-sleutel. Het bovenstaande verzoek stelt max_tokens in op 5 om de test klein te houden. Bij normaal gebruik is max_tokens optioneel, en kan de completion elk resterend deel van het 100.000-token contextvenster gebruiken na je prompt.
Streaming vanaf de command line
Stel "stream": true in en voeg -N toe zodat curl de output niet bufferd. Je ziet lijnen die beginnen met data:, elk met een kleine JSON-delta, en een laatste data: [DONE]. Het chunk ervoor bevat tokengebruik.
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
Om alleen de tekst af te drukken, filter je de stream met een korte pipeline:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
Een gestreamd verzoek houdt zijn concurrency slot vast tot de stream eindigt. Als je veel streams parallel start vanuit een script en vergeet ze te laten eindigen, raak je de concurrency limiet, zelfs als de request rate laag is.
JSON-modus en toolaanroepen
JSON-modus zorgt ervoor dat het model een enkel geldig JSON-object retourneert. Geef de gewenste vorm ook op in de prompt, anders zijn de sleutels wat het model kiest.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
Tool calling gebruikt de standaard tools en tool_choice velden. Het model antwoordt met een tool_calls array in plaats van tekst; je voert de functie zelf uit en stuurt het resultaat terug als een bericht met role: "tool" en de bijpassende tool_call_id.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
Kijk in het antwoord naar choices[0].message.tool_calls[0].function.arguments. Het is een JSON string die je parseert, je eigen weerfunctie mee aanroept en terugstuurt in het volgende verzoek. Parameters zoals temperature, top_p, stop, seed en de penalties worden doorgegeven. De documentatie somt alle ondersteunde velden op.
Houd de token veilig en de commando's netjes
Een Bearer-token is een wachtwoord met een andere naam. Iedereen die het heeft, kan je tegoed uitgeven, dus behandel het met dezelfde zorg. Plak nooit een echte sleutel in een publiek probleem, een screenshot of een gedeelde terminallog. Als je vermoedt dat een sleutel is gelekt, vervang hem dan via de sleutelpagina en update je scripts.
Shellgeschiedenis is de meest voorkomende lek op een persoonlijke machine. De sleutel direct in een commando typen slaat deze op in het geschiedenisbestand. Het eenmaal instellen met export slaat die regel ook op. Twee schonere gewoontes helpen. Lees de sleutel uit een bestand dat alleen jij kunt openen, of prefix het commando met een spatie als je shell is ingesteld om regels die met een spatie beginnen te negeren. Een klein bestand werkt goed:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
Lange JSON-lichamen zijn moeilijk te lezen binnen enkele aanhalingstekens, en het citeren faalt zodra de prompt zelf een apostrof bevat. Zet de inhoud in een bestand en laat curl het lezen met -d @file:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
Dezelfde aanpak houdt grote prompts binnen de 8 MB-limiet hanteerbaar, en een bestand kan in git worden versiebestuurd terwijl de sleutel buiten de opslagplaats blijft. Op Windows PowerShell gedragen aanhalingstekens rond JSON zich anders en bestaat de backslash-lijncontinuatie niet; de -d @request.json vorm vermijdt beide problemen, en je kunt een backtick aan het eind van een regel gebruiken om een opdracht voort te zetten.
Als je klaar bent met testen, ga dan over op een SDK. De OpenAI Python- en Node-bibliotheken accepteren dezelfde basis-URL en sleutel, handelen herhalingen en streaming voor je af, en lezen dezelfde responsindeling die je hier handmatig hebt geparsed. De cURL-opdrachten blijven de snelste manier om te controleren of een fout komt door je code of door het verzoek zelf, dus houd een bekende goede in je notities. Als je een probleem rapporteert aan support, voeg dan de X-Request-Id van het mislukte verzoek en de exacte statuscode toe; dit paar stelt iemand in staat het verzoek te vinden zonder dat je de test hoeft te herhalen, en bespaart een ronde van heen en weer.
Fouten, herhalingen en kosten per aanroep
Als je een limiet overschrijdt, antwoordt de API met HTTP 429. De foutcode vertelt je welke limiet: rate_limited betekent te veel verzoeken per minuut, concurrency betekent te veel in één keer. Een tijdelijke overload retourneert ook 429 en voegt Retry-After: 5 toe. curl kan zelf opnieuw proberen voor tijdelijke fouten:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
Houd de inhoud ook onder de 8 MB, wat belangrijk is als je bestanden die in de prompt zijn gecodeerd posten.
Mislukte of geweigerde verzoeken worden niet in rekening gebracht. Geslaagde verzoeken volgen een eenvoudige formule: $0,15 per 1M invoertokens en $0,50 per 1M uitvoertokens. Een testaanroep met 40 invoertokens en 120 uitvoertokens kost 40 / 1.000.000 x $0,15 = $0,000006 plus 120 / 1.000.000 x $0,50 = $0,00006, dus $0,000066 in totaal. Een duizend daarvan komt neer op $0,066.
Krediet is vooruitbetaald en verloopt nooit. Opwaarderingen lopen van $20 tot $500 in hele bedragen, met een bonus van 5% vanaf $50, 10% vanaf $100 en 15% vanaf $200, per crypto (USDT op TRC20, USDC op Base). De prijzenpagina toont de details. Als een antwoord verkeerd lijkt, legt de mythes en feiten pagina uit wat het model wel en niet doet.
Meer handleidingen
Vragen en antwoorden
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele installatie.
Waar komt de token in een cURL-commando?
- In een header: -H "Authorization: Bearer YOUR_KEY". De request body vereist ook de Content-Type: application/json header.
Welke modelnaam moet ik gebruiken?
- Gebruik uncensored. Je kunt dit bevestigen met GET /v1/models.
Waarom krijg ik 429?
- Je hebt een limiet overschreden. De code rate_limited betekent te veel verzoeken per minuut, concurrency betekent te veel in één keer. Wacht een paar seconden of verlaag het aantal gelijktijdige verzoeken.
Hoe zie ik mijn resterende tegoed?
- Elk antwoord bevat een X-Balance-USD header. Print headers met curl -i of curl -D -.
Is dit de officiële OpenAI API?
- Nee. Het is een onafhankelijke OpenAI-compatibele service die één open-weight model draait, dus SDK's en cURL-opdrachten die voor het OpenAI-formaat zijn gemaakt, werken na het wijzigen van de base URL en de sleutel.