NL ▾
API-sleutel aanvragen
OpenAI-compatibele ongecensureerde API voor ontwikkelaars.Gepubliceerd

Voorbeelden van LLM API curl-verzoeken die je kunt kopiëren en uitvoeren

Wil je een LLM-API curl-test doen voordat je code schrijft? De onderstaande verzoeken volstaan. Elk verzoek richt zich op een OpenAI-compatibel endpoint, gebruikt de model-ID uncensored en voert uit vanuit een gewone terminal.

Terminalpaneel dat een lichtstraal naar een serverblok stuurt, wat een curl-verzoek naar een LLM API voorstelt

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

StatuscodeWaarschijnlijke oorzaakOplossing
401Ontbrekende of verkeerde sleutelControleer de Authorization header en of $API_KEY is geëxporteerd
400Verkeerd gevormde JSON of veldfoutValideer het verzoeklichaam met jq . voordat je het verzendt
429, code rate_limitedMeer dan 300 verzoeken per minuut (60 op een proefsleutel)Vertraag je lus
429, code concurrencyMeer dan 8 verzoeken tegelijk (2 op een proefsleutel)Voer minder gelijktijdige taken uit
429 met Retry-After: 5Tijdelijke overbelastingWacht 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).

Vragen en antwoorden

Naar welke URL stuur je curl-verzoeken?

Gebruik https://api.uncensoredllmapi.com/v1 als de basis, voeg dan /chat/completions, /responses, /models of /balance toe afhankelijk van wat je nodig hebt.

Hoe test je toolaanroepen met curl?

Voeg een tools-array met een functiedefinitie toe aan het chatcompletie-body. Als het model besluit deze aan te roepen, bevat het antwoord tool_calls en stuur je het resultaat terug als een bericht met de rol tool.

Waarom toont curl niets totdat het antwoord klaar is?

Je streamt waarschijnlijk zonder de -N-vlag. Voeg -N toe zodat curl elk chunk afdrukt wanneer het aankomt.

Kost een mislukt verzoek geld?

Nee. Mislukte of geweigerde verzoeken worden niet aangerekend.

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.