OpenAI API key: kosten, instellen en je eerste request

👁 115 keer gelezen

Een OpenAI API key, de sleutel tot de programmeerinterface van OpenAI, werkt heel anders dan een abonnement op ChatGPT. Voor de API betaal je per token in plaats van een vast maandbedrag, en je integreert de modellen direct in je eigen scripts, dashboards of applicaties. Je maakt binnen enkele minuten een sleutel aan via platform.openai.com en een eerste aanroep in Python kost slechts vijf regels code. Hieronder leggen we uit hoe je een account instelt, wat een miljoen tokens kost, hoe je eerste request eruitziet en hoe je je sleutel beveiligt.

Wat is de OpenAI API en waarin verschilt deze van ChatGPT?

De API is een eindpunt op api.openai.com waar je applicatie tekst (of afbeeldingen en audio) naartoe stuurt en een respons van het model voor terugkrijgt. Er is geen standaard chatinterface, geen gespreksgeschiedenis en geen ingebouwd geheugen: alle context die het model nodig heeft, stuur je mee in het verzoek. De afrekening gebeurt op basis van tokens: ongeveer 750 Engelstalige woorden staan gelijk aan 1000 tokens (voor het Nederlands ligt dit aantal woorden per 1000 tokens doorgaans iets lager).

Een ChatGPT-abonnement (zoals Go, Plus of Pro) sluit je af via chatgpt.com en geldt uitsluitend voor die interface. Het API-platform vind je op platform.openai.com, compleet met een eigen prepaid-saldo, facturatie en gebruikslimieten. Je kunt voor beide hetzelfde e-mailadres gebruiken, maar de tegoeden zijn strikt gescheiden. Welke optie voordeliger uitvalt, behandelen we in ons overzicht over abonnement versus API.

Stap voor stap een API key aanmaken

• Account: ga naar platform.openai.com en log in met je OpenAI-account (hetzelfde account als voor ChatGPT of maak een nieuw account aan). Het platform maakt een organisatie aan waarin je projecten, sleutels en facturen beheert.
• Factuurgegevens: ga naar Settings, Organization, Billing, Billing details. Als je zakelijk inkoopt, kies dan voor “Business” en vul je btw-identificatienummer in (met landcode NL of BE) voordat je tegoed toevoegt; reeds uitgereikte facturen kunnen achteraf niet meer worden aangepast.
• Tegoed opwaarderen: betalen doe je vooraf per creditcard. OpenAI biedt standaard geen gratis starttegoed; met een eerste opwaardering van 5 USD activeer je Tier 1. Stel eventueel direct automatische herlading in (of schakel dit juist uit om onverwachte kosten te voorkomen).
• API key genereren: ga naar platform.openai.com/api-keys en klik op “Create new secret key”. Koppel de sleutel bij voorkeur aan een specifiek project en beperk de rechten. De sleutel begint met sk- en wordt maar eenmalig getoond; sla deze meteen op in een wachtwoordmanager.

De beschikbare limieten hangen af van je accountniveau. Volgens de officiële documentatie van OpenAI gelden de volgende niveaus:

Naarmate je niveau stijgt, worden ook de limieten voor het aantal requests en tokens per minuut automatisch verruimd, berekend per specifiek model.

Tarieven van de modellen

Onderstaande tarieven komen uit de officiële prijslijst van OpenAI, per miljoen tokens en exclusief btw. Onder “Cache” vallen input-tokens die identiek zijn aan een recent verzoek (zoals een vaste, uitgebreide systeeminstructie), waarvoor een sterk verlaagd tarief geldt.

Drie praktijkscenario’s berekend op basis van deze tarieven:

• FAQ-chatbot op je website: 10.000 gesprekken per maand van elk circa 1500 input-tokens (inclusief prompt) en 300 output-tokens. Op Luna: 15 mln × 0,10 + 3 mln × 0,50 = 3 USD. Op Sol: 60 USD.
• Documenten samenvatten: 500 bestanden van elk ongeveer 10.000 tokens met een samenvatting van 500 tokens. Op Sol kost dit 12,50 USD, of 6,25 USD via de Batch API.
• Analytische assistent op Astra: 6000 queries per maand van elk 8000 input-tokens (waarvan 70 procent gecachet) en 1500 output-tokens. Input kost circa 178 USD en output 450 USD, wat neerkomt op zo’n 628 USD in totaal. Dit toont aan dat de modelkeuze vaak meer invloed op de factuur heeft dan het pure aantal verzoeken.

Wil je deze tarieven vergelijken met modellen van andere aanbieders via één centrale interface, bekijk dan ons artikel over prijzen bij OpenRouter; de functionele verschillen binnen de GPT-6-familie lichten we toe in onze analyse van de GPT-6 Sol en Luna prijzen.

Je eerste API-aanroep

Bewaar je sleutel altijd in een omgevingsvariabele en zet deze nooit rechtstreeks in je code: gebruik export OPENAI_API_KEY="sk-..." op macOS en Linux, of setx OPENAI_API_KEY "sk-..." op Windows. De officiële clientbibliotheek leest deze variabele automatisch uit. Een minimaal voorbeeld via de Responses API:

pip install openai

from openai import OpenAI
client = OpenAI()
response = client.responses.create(
    model="gpt-6-luna",
    input="Streść w dwóch zdaniach, czym jest token."
)
print(response.output_text)

(De geteste prompt luidt vertaald: “Vat in twee zinnen samen wat een token is.”)

Hetzelfde doe je via curl met een POST-verzoek naar https://api.openai.com/v1/responses met de header Authorization: Bearer $OPENAI_API_KEY en een JSON-body met de parameters model en input. De Responses API is de moderne standaardinterface en biedt ondersteuning voor server-side statusbeheer en tools zoals web search en functies. Veelvoorkomende HTTP-foutcodes om rekening mee te houden: 401 (ongeldige API key), 429 (limiet bereikt of onvoldoende saldo; OpenAI adviseert exponential backoff met jitter op basis van de Retry-After header) en 5xx (tijdelijke serverfout).

Beveiliging van je API key

• Plaats je sleutel nooit in openbare repositories of client-side code in de browser; roep de API uitsluitend aan vanaf je eigen backend. Geautomatiseerde bots scannen GitHub continu op gelekte API keys.
• Gebruik afzonderlijke sleutels per project met minimale permissies en verwijder inactieve sleutels direct.
• Stel onder Billing, Limits een maandelijks budget en waarschuwingsdrempels in; een oneindige loop in een script kan anders in één nacht je volledige saldo verbruiken.
• Bij een lek: trek de sleutel direct in via platform.openai.com/api-keys (deze stopt onmiddellijk met werken), controleer je verbruik onder Usage, maak een nieuwe sleutel aan en wis de commit-historie. Uit onderzoek geciteerd in ons artikel over datalekken bij AI-toegangssleutels blijkt dat dit probleem bij maar liefst 98 procent van de bedrijven voorkomt.

Veelgestelde vragen

Krijg je gratis starttegoed bij de OpenAI API?

De officiële documentatie vermeldt geen gratis tegoed bij registratie. Je moet eerst saldo opwaarderen om requests te kunnen versturen; een bedrag van 5 USD is voor een licht model als Luna echter al goed voor vele duizenden verzoeken.

Worden API-gegevens gebruikt om modellen te trainen?

Nee. Volgens het databeleid van OpenAI worden gegevens die via de API worden verzonden sinds 1 maart 2023 niet gebruikt voor het trainen van modellen, tenzij je hier expliciet toestemming voor geeft. Logs voor misbruikdetectie worden maximaal 30 dagen bewaard. Zakelijke klanten die aan bepaalde voorwaarden voldoen kunnen zero data retention aanvragen, en voor Europese organisaties is er een specifiek eindpunt beschikbaar via eu.api.openai.com met dataverwerking binnen de EER.

Hoe zit het met de btw op zakelijke facturen?

Voor klanten binnen de Europese Economische Ruimte levert OpenAI via OpenAI Ireland Ltd. Als je bij de facturatiegegevens een geldig Europees btw-identificatienummer invoert, wordt de factuur uitgereikt met btw verlegd (reverse charge). Zonder geldig btw-nummer brengt OpenAI automatisch het Ierse btw-tarief van 23 procent in rekening. Hoe je de administratie rondom buitenlandse AI-diensten inricht, lees je in ons artikel over betalingen voor buitenlandse AI-tools.

// lees verderTraag internet in de avond? 3 wifi-instellingen om te checkenHandleidingenCustomer.io stap voor stap: mensen, events en eerste automatiseringHandleidingenHotel Lobby AI maken: kosten, tools en promptsHandleidingen

Kinetyra