Wat je nodig hebt voordat je begint
Een n8n-instantie (cloud of self-hosted) en een API-sleutel van deze dienst. Heb je nog geen sleutel? De API-sleutelpagina leidt je door de registratie met Google of e-mail en wachtwoord. Nieuwe gebruikers kunnen met één klik op die pagina $0,50 aan proeftegoed claimen, geldig voor 7 dagen en zonder kaart.
Drie waarden ga je in n8n in:
- Basis-URL:
https://api.onekeyllmapi.com/v1 - API-sleutel: verstuurd als
Authorization: Bearer <key>, wat n8n voor je verzendt - Model ID:
uncensored
De service is een gehoste, tekst-only LLM API die het OpenAI-verzoekformaat volgt voor /v1/chat/completions, /v1/responses en /v1/models. Het is niet de officiële API van een modelvendor, dus alles wat n8n naar het chat endpoint van OpenAI stuurt, werkt hier zolang het een tekstverzoek is.
Stap 1: Maak de referentie aan
Open in n8n Credentials, kies Referentie aanmaken en zoek naar OpenAI API. Vul het als volgt in:
- Plak je sleutel in het veld API Key.
- Laat Organization ID leeg.
- Vervang de standaard Base URL door
https://api.onekeyllmapi.com/v1. Laat de/v1aan het eind staan en voeg geen/chat/completionstoe. - Sla op. n8n voert een kleine testcall uit bij het opslaan; als dit mislukt, ga dan naar de sectie voor probleemoplossing hieronder.
Houd één referentie per omgeving aan. Als je een staging-omgeving en een productie-omgeving van n8n draait, geef dan elk zijn eigen sleutel zodat je de uitgaven gescheiden kunt zien en er één kunt intrekken zonder de andere aan te raken.
Stap 2: Bouw een eenvoudige chat workflow
Begin met het kleinste ding dat de verbinding bewijst: een handmatige trigger en één modelaanroep.
- Voeg een Manual Trigger-knooppunt toe.
- Voeg een OpenAI-knooppunt toe (of het OpenAI Chat Model sub-knooppunt binnen een Basic LLM Chain, afhankelijk van je n8n-versie) en selecteer de referentie uit stap 1.
- Zoek voor het model naar een manier om een ID handmatig in te voeren. Nieuwere n8n-versies bieden een Op ID-modus naast de lijst. Typ daar
uncensored. De lijst kan leeg zijn of alleen OpenAI-namen tonen, omdat n8n deze aan zijn kant filtert. - Voeg een prompt toe zoals Vat dit supportticket samen in twee zinnen en voer het knooppunt uit.
Als je n8n-versie aandraagt om uit een lijst te kiezen, gebruik dan de HTTP-verzoek-aanpak in de volgende sectie. Die werkt altijd omdat je het hele verzoek bestuurt.
De API aanroepen met de HTTP Request-node
Het HTTP Request-knooppunt is de meest voorspelbare manier om deze API aan te roepen vanuit n8n, en het blootstelt elke parameter die de API accepteert, waaronder seed, stop, top_p en tools. Configureer het als volgt:
- Methode:
POST - URL:
https://api.onekeyllmapi.com/v1/chat/completions - Authenticatie: Generic Credential Type met Header Auth, naam
Authorization, waardeBearer YOUR_KEY - Body verzenden: aan, content type JSON
Body (zet het veld op Expression als je gegevens uit eerdere knooppunten wilt invoegen):
{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Summarize this support ticket in two sentences."}
],
"temperature": 0.4
}
De antwoordtekst staat bij choices[0].message.content. In het volgende knooppunt kun je hierop verwijzen met {{ $json.choices[0].message.content }}.
Om hetzelfde verzoek eerst buiten n8n te testen, voer dit in een terminal uit:
curl https://api.onekeyllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'
Als curl werkt en n8n niet, dan ligt het probleem in de node-instellingen, niet in je sleutel of saldo.
JSON-modus voor workflows die de output parseren
Workflows breken wanneer een model gegevens verpakt in vriendelijke tekst. JSON-modus vraagt de API om een geldig JSON-object terug te geven, dat je direct kunt doorgeven aan een Set- of IF-knooppunt. Voeg response_format toe aan de body:
{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
{"role": "user", "content": "The delivery was late but support fixed it fast."}
]
}
Twee gewoontes maken dit betrouwbaar. Vermeld eerst het woord JSON en noem de sleutels in de prompt, omdat JSON-modus syntaxis garandeert, niet je schema. Ten tweede komt het antwoord nog steeds als een string aan bij message.content, dus voeg een Code-knooppunt of een expressie met JSON.parse() toe voordat je velden uitleest. In het OpenAI-knooppunt verschijnt dezelfde schakelaar als een Response Format-optie onder de knooppuntopties.
429 en andere fouten afhandelen
n8n voert items parallel uit, dus een batch van 50 rijen kan snel tegen limieten aanlopen. Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe; een proefsleutel staat 2 en 60 toe. Als je dit overschrijdt, antwoordt de API met HTTP 429 en de code rate_limited (te veel per minuut) of concurrency (te veel in één keer). Bij tijdelijke overbelasting krijg je 429 met een Retry-After: 5-header.
Praktische instellingen in n8n:
- Open het knooppunt, ga naar Settings, schakel Retry On Fail in, stel Max Tries in op 3 of 4 en Wait Between Tries op 5000 ms.
- Plaats een Loop Over Items-knooppunt (batchgrootte 4 tot 6) voorafgaand aan de modelaanroep, zodat je onder de 8 gelijktijdige verzoeken blijft.
- Onder knooppunt Settings kan On Error worden ingesteld om door te gaan met een uitvoer bij fout, zodat één slechte rij de run niet stopt.
Voor een diepere blik op de twee soorten limieten, lees de API-documentatie. Andere fouten zijn eenvoudig: een 401 betekent dat de sleutel onjuist is of dat de header het woord Bearer mist, en een 404 betekent meestal dat de Base URL een typefout bevat of een extra padsegment.
Probleemoplossingscontrolelijst
De meeste fouten komen door een korte lijst van oorzaken. Werk deze van boven naar beneden af voordat je de service verdenkt.
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| 401 bij opslaan of uitvoeren | Onjuiste sleutel, of de header mist Bearer | Plak de sleutel opnieuw; bij Header Auth moet de waarde beginnen met Bearer |
| 404 | De Base URL bevat een typefout of een extra padsegment | Gebruik exact https://api.onekeyllmapi.com/v1 in de referenties |
| Model niet gevonden | Model-ID is niet getypt als uncensored | Schakel over naar Op ID, of gebruik de HTTP-verzoeknode |
| 429 met concurrency | Meer dan 8 gelijktijdige runs (2 op een proef-sleutel) | Batch met Lussen over items en voeg retries toe |
| JSON-parseerfout downstream | Het antwoord is een string, of de prompt noemde de velden niet | Parseren met JSON.parse() en beschrijf de sleutels in de system prompt |
Neem bij contact met support de X-Request-Id-responseheader van de mislukte call mee. In n8n zie je headers door Include Response Headers and Status in de opties van de HTTP-verzoeknode in te schakelen.
Testen zonder veel geld uit te geven
Gebruik het proeftegoed terwijl je bouwt. Bij 2 gelijktijdige verzoeken en 60 verzoeken per minuut is een proefsleutel traag voor batches, maar meer dan genoeg om een credential, een prompt en de parsing-logic te controleren. Schakel over op een volledige sleutel wanneer je de workflow naar een schema verplaatst.
Kosten en een doordacht workflowontwerp
Prijzen zijn pay as you go: $0,15 per 1M input tokens en $0,50 per 1M output tokens, van prepaid credit. Een workflow die 1.000 e-mails per dag classificeert met 600 input en 100 output tokens per e-mail, gebruikt 0,6M input tokens ($0,09) en 0,1M output tokens ($0,05), ongeveer $0,14 per dag. Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus retries bij fouten verdubbelen de rekening niet. Details staan op de prijzenpagina.
Houd prompts kort, stuur alleen de velden die het model nodig heeft, en stel max_tokens in wanneer je weet dat het antwoord kort is. Als je ook modellen op je eigen machine draait, zie dan het artikel over een lokale LLM gebruiken via een OpenAI-style API, die dezelfde clientinstellingen gebruikt.
