NL ▾
API-sleutel aanvragen

OpenAI-compatible API in n8n: installatiegids

Als je zocht naar openai compatible api n8n, is het korte antwoord dat je slechts twee waarden in de OpenAI-credential aanpast: de Base URL en de API-sleutel. De rest van de workflow blijft hetzelfde als bij elke OpenAI-node.

Bijgewerkt

Isometrisch automatiseringsworkflow met verbonden blokken die data naar een API-endpoint sturen

Belangrijkste punten

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:

  1. Plak je sleutel in het veld API Key.
  2. Laat Organization ID leeg.
  3. Vervang de standaard Base URL door https://api.onekeyllmapi.com/v1. Laat de /v1 aan het eind staan en voeg geen /chat/completions toe.
  4. 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.

  1. Voeg een Manual Trigger-knooppunt toe.
  2. 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.
  3. 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.
  4. 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, waarde Bearer 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.

SymptoomWaarschijnlijke oorzaakOplossing
401 bij opslaan of uitvoerenOnjuiste sleutel, of de header mist BearerPlak de sleutel opnieuw; bij Header Auth moet de waarde beginnen met Bearer
404De Base URL bevat een typefout of een extra padsegmentGebruik exact https://api.onekeyllmapi.com/v1 in de referenties
Model niet gevondenModel-ID is niet getypt als uncensoredSchakel over naar Op ID, of gebruik de HTTP-verzoeknode
429 met concurrencyMeer dan 8 gelijktijdige runs (2 op een proef-sleutel)Batch met Lussen over items en voeg retries toe
JSON-parseerfout downstreamHet antwoord is een string, of de prompt noemde de velden nietParseren 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.

Vragen en antwoorden

Welke n8n-nodes werken met een aangepaste base URL?

Elke node die de OpenAI-referentie gebruikt, kan deze gebruiken, omdat het veld Base URL bij de referentie hoort. Als een node geen parameter blootgeeft die je nodig hebt, gebruik dan de HTTP-verzoeknode.

Waarom is de modellenlijst leeg of fout in n8n?

n8n laadt en filtert de lijst aan zijn kant. Voer de model-ID uncensored handmatig in, of gebruik de HTTP-verzoeknode waar het model gewoon een veld in de body is.

Kan ik streaming in n8n gebruiken?

De API ondersteunt streaming over SSE, maar de meeste n8n-nodes wachten op het volledige antwoord voordat ze data doorgeven. Voor workflows is een normale niet-gestreamede aanroep eenvoudiger.

Hoe controleer ik mijn saldo vanuit een workflow?

Roep GET /v1/balance aan, of lees de X-Balance-USD-header op elk antwoord, en voeg een IF-node toe die je waarschuwt wanneer het onder een drempelwaarde daalt.

Je sleutel is nog maar één stap verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.