Stel je shell in en controleer het endpoint
Haal een sleutel op van de API-sleutelpagina en exporteer deze samen met de basis-URL, zodat je geen geheimen in elke opdracht hoeft te plakken.
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
Elk verzoek verzendt de sleutel als bearer token in de Authorization header. Verzoeklichamen zijn JSON, dus voeg Content-Type: application/json toe bij een POST. De maximale grootte van het verzoeklichaam is 8 MB, wat alleen relevant is als je zeer grote documenten in de prompt plakt.
De voorbeelden gebruiken de enkele aanhalingstekens van een Unix-shell. Op Windows PowerShell kun je de JSON in een bestand plaatsen en deze doorgeven met --data @body.json om aanhalingstekensproblemen te vermijden.
De goedkoopste basiscontrole is een GET die de modellen opsomt. Dit bevestigt de sleutel en de URL en kost niets.
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
De data array in het antwoord moet de ID uncensored bevatten. Een 401 betekent dat de sleutel ontbreekt of verkeerd is getypt. Als curl helemaal geen verbinding kan maken, controleer dan de host in $BASE en zorg dat deze eindigt op /v1 zonder extra pad.
1. Stuur een chatcompletie
Dit is het verzoek dat elke OpenAI-achtige client onder de motorkap verzendt.
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
Het antwoord is JSON. De tekst staat bij choices[0].message.content en de tokenaantallen staan bij usage. Pijp de uitvoer door jq -r '.choices[0].message.content' als je jq hebt geïnstalleerd en alleen de tekst wilt. Het veld max_tokens is optioneel; laat het weg en de completie gebruikt wat er over is van het 100.000-token contextvenster.
Het nieuwere POST /v1/responses endpoint is ook beschikbaar als je client dat formaat gebruikt. Zie de documentatie voor de volledige lijst met parameters.
2. Stream het antwoord
Voeg "stream": true toe en vertel curl niet te bufferen met -N. Tokens worden afgedrukt zodra ze gegenereerd zijn.
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
Elke regel begint met data: en bevat een klein JSON-blok met een delta. De laatste gebeurtenissen bevatten verbruiksinformatie en de stream eindigt met data: [DONE]. Zonder -N wacht curl op een volledig buffer en lijkt de uitvoer in één keer aan te komen. Let op: een gestreamd verzoek houdt één gelijktijdige verbindingsruimte bezet tot het einde.
3. Vraag om JSON
Schakel JSON-modus in met response_format voor uitvoer die een script zal parseren. Vermeld het woord JSON in de prompt zodat het model weet welke vorm je verwacht.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
De definitieve fromjson filter parseert de string binnen content, dus jq faalt luidruchtig als het model iets retourneert dat geen geldige JSON is. Dit maakt het tot een handige snelle test. Meer patronen staan op de JSON-modus-pagina.
4. Probeer een toolaanroep
Function calling stelt het model in staat je code een functie te laten uitvoeren. Je beschrijft de functie in een tools array en als het model besluit deze te gebruiken, bevat het antwoord een tool_calls item in plaats van tekst.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
Je zou een functienaam en een JSON-string van argumenten moeten krijgen. Je code voert de functie uit en stuurt vervolgens een tweede verzoek dat de eerdere berichten herhaalt, de assistant-bericht met de toolaanroep toevoegt en een bericht toevoegt met role: "tool" dat het resultaat bevat. Het model schrijft vervolgens het definitieve antwoord.
5. Controleer headers en saldo
Voeg -i toe om antwoordheaders samen met het verzoeklichaam te zien. Je vindt daar X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency.
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
De tweede aanroep retourneert je tegoed direct. OpenAI-compatibele tools kunnen in plaats daarvan GET /v1/dashboard/billing/credit_grants gebruiken. Een klein verzoek zoals hierboven kost een fractie van een cent: met 10 inputtokens en 5 outputtokens is de prijs 10 x 0,15 / 1.000.000 + 5 x 0,50 / 1.000.000 = $0,000004. Zie de prijzenpagina voor de tarieven.
Een herbruikbaar smoke-testscript
Zodra je de individuele aanroepen vertrouwt, verpak ze dan in een kort script dat je kunt uitvoeren na elke deploy, sleutelrotatie of netwerkwijziging. Het faalt bij het eerste probleem, zodat je precies ziet welke stap het niet deed.
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
De -f-vlag zorgt ervoor dat curl een foutmelding geeft bij HTTP-fouten, en set -e stopt het script daar. Voeg dit toe aan een cronjob of een CI-stap als je een service op deze API draait en tijdig wilt worden gewaarschuwd bij wijzigingen. Bewaar de sleutel in een geheimenopslag of omgevingsvariabele, nooit in het scriptbestand zelf.
Als je het verzoek varieert, pas dan één instelling tegelijk aan: temperature voor willekeur, top_p voor nucleus sampling, stop voor aangepaste eindsequenties en seed voor reproduceerbare uitvoer. Alles wordt doorgegeven aan het model, zodat je het effect kunt vergelijken vanuit dezelfde terminalgeschiedenis.
Fouten van curl lezen
| Statuscode | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| 401 | Ontbrekende of verkeerde sleutel | Controleer de Authorization header en of $API_KEY is geëxporteerd |
| 400 | Verkeerd gevormde JSON of veldfout | Valideer het verzoeklichaam met jq . voordat je het verzendt |
429, code rate_limited | Meer dan 300 verzoeken per minuut (60 op een proefsleutel) | Vertraag je lus |
429, code concurrency | Meer dan 8 verzoeken tegelijk (2 op een proefsleutel) | Voer minder gelijktijdige taken uit |
429 met Retry-After: 5 | Tijdelijke overbelasting | Wacht 5 seconden en probeer opnieuw |
Voeg -w "\n%{http_code}\n" toe om de statuscode na de body af te drukken, zodat je niet hoeft te raden. Foutmeldingen zijn JSON met een bericht en een code; jq .error toont deze netjes. Als je een 429 in een lus ziet, probeer het niet direct opnieuw; een pauze van een paar seconden geeft het minutenvenster en de gelijktijdige slots de tijd om vrij te komen. Een strakke retry-lus houdt je alleen boven de limiet. Een proefsleutel heeft strengere limieten dan een volledige sleutel, dus een script dat werkt na je eerste top-up, kan falen met proeftegoed als het taken parallel uitvoert. Zodra de verzoeken stabiel zijn, schakel dan over op een SDK; dezelfde URL en modelnaam blijven ongewijzigd. Nieuwe accounts kunnen met één klik $0,50 aan proeftegoed claimen, genoeg voor honderden kleine testverzoeken. Top-ups daarna beginnen bij $20 en worden betaald in crypto (USDT op TRC20 of USDC op Base).
