Eén regel code, en je draait in de Europese Unie.

Quickstart: je eerste API-call

Maak een key aan in je dashboard onder Instellingen, API-keys. Je ziet het geheim precies één keer. Daarna bewaren we alleen een hash en het prefix. Zet het in een omgevingsvariabele, nooit in je repository.

curl https://api.europeanailab.eu/v1/chat/completions \
  -H "Authorization: Bearer $UNION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "eu-standard",
    "messages": [{"role": "user", "content": "Leg uit hoe btw verleggen werkt."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # de enige regel die verandert
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Leg uit hoe btw verleggen werkt."}],
)
print(resp.choices[0].message.content)

Modeltiers en contextvensters

In het veld model geef je een tier mee, geen modelnaam. Zo blijft je integratie werken als we het model eronder vervangen, en dat gaan we doen, want open-weight modellen worden uitgefaseerd en ingehaald.

Ga je over het contextvenster van een tier heen, dan krijg je een 400 met het maximum erin: we kappen je prompt nooit stilletjes af.

Responses streamen

Streaming werkt zoals je verwacht, met één belangrijk verschil dat je moet kennen, want het gaat over je geld.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Schrijf een samenvatting."}],
    stream=True,
    # Zonder dit is er geen usage-object en zie je de kosten niet.
    stream_options={"include_usage": True},
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
    if chunk.usage:                      # laatste chunk
        print("\n", chunk.usage)

Breek je een stream halverwege af, dan betaal je alleen voor wat er tot dat moment gegenereerd is. Komt er door de verbroken verbinding geen usage-chunk binnen, dan schatten we het verbruik en corrigeren we het bij de dagelijkse afstemming met onze provider. Zo’n regel staat in je verbruiksoverzicht als estimated tot hij verrekend is.

Function calling en tool use

Tools volgen het bekende schema. Produceert een model een tool call die niet bij je schema past, dan loggen we dat: in versie 1 corrigeren we het niet stilletjes, want je output ongemerkt repareren is erger dan een zichtbare fout.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Zoek een factuur op nummer op.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

resp = client.chat.completions.create(
    model="eu-standard", messages=messages, tools=tools
)

Gestructureerde output met een JSON schema

Geef een JSON schema mee en valideer het antwoord aan jouw kant. Ons advies: valideer altijd, ook als het model zich meestal netjes gedraagt.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Haal de naam en het bedrag eruit."}],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "invoice",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "amount_eur": {"type": "number"},
                },
                "required": ["name", "amount_eur"],
            },
        },
    },
)

Response-headers: kosten, tier en routing

Elke response vertelt wat er gebeurd is. Dat is geen debugextraatje, het is de bedoeling: je kunt zelf nagaan of je kreeg waarvoor je betaalde.

Rate limits en uitgaveplafonds

Er geldt een limiet per key en per account, plus de plafonds die je zelf instelt. Die laatste zijn belangrijker dan ze klinken: zonder plafond kan een uitgelekte key of een oneindige lus in je eigen code in één nacht een saldo leegtrekken.

• Requests per minuut, per key en per account.
• Dag- en maandplafond in euro’s, per key in te stellen.
• Nieuwe accounts: de eerste 48 uur maximaal € 25 per dag, wat het saldo ook is.
• Zien we binnen een uur meer dan tien keer je weekgemiddelde, dan pauzeren we de key automatisch en mailen we je. Liever één vals alarm dan een lege portemonnee.
• Een request start pas als je saldo minstens € 0,05 is.

Foutcodes en wat je ermee doet

Mislukte requests kosten je niets: kwam er geen bruikbaar antwoord terug, dan gaat er niets van je saldo af.

Fair use en gebruiksbeleid

We weigeren instructies voor wapens, malware en fraude, en materiaal dat kinderen schaadt. Die weigeringen zijn definitief: we sturen zo’n request nooit door naar een ander model om er toch een antwoord uit te krijgen.

Een model dat een legitieme vraag over politiek, geschiedenis of een maatschappelijk gevoelig onderwerp weigert, is iets anders: dat behandelen we als een defect en sturen we naar een model zonder die blinde vlek. Je ziet het aan de header X-EU-Routed: censorship.

Eén van onze modellen heeft een licentie met een eigen gebruiksbeleid. Dat beleid geldt volledig: omleiden is geen manier om licentievoorwaarden te omzeilen.

Twijfel je of je toepassing past? Mail hello@europeanailab.eu. Vooraf een antwoord is voor ons allebei goedkoper dan achteraf een geblokkeerde key.

Veelgestelde vragen

De vragen die per mail binnenkomen voordat iemand een key aanmaakt: waarmee de API compatibel is, wat een request kost en waar het draait.

Een bestaande integratie overzetten is drie regels: de key, de base URL en een tiernaam. De hele wijziging, plus wat niet meeverhuist, staat in overstappen in drie regels. Nog iets open? De tarieven per tier staan op de prijspagina, het model en de licentie achter elke tier bij AI-transparantie, en wat er gebeurt bij een storing op de statuspagina. Twee langere stukken: wat een AI-API per token kost en waar je prompts echt naartoe gaan.