Eine Zeile Code, und du läufst in der Europäischen Union.

Schnellstart: dein erster API-Aufruf

Erstelle in deinem Dashboard unter Einstellungen, API-Schlüssel einen Schlüssel. Das Secret siehst du genau einmal. Danach speichern wir nur noch einen Hash und das Präfix. Leg es in eine Umgebungsvariable, niemals in dein 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": "Erkläre das Reverse-Charge-Verfahren nach § 13b UStG."}]
  }'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["UNION_API_KEY"],
    base_url="https://api.europeanailab.eu/v1",   # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Erkläre das Reverse-Charge-Verfahren nach § 13b UStG."}],
)
print(resp.choices[0].message.content)

Modellstufen und Kontextfenster

Im Feld model übergibst du eine Stufe, keinen Modellnamen. So funktioniert deine Integration weiter, wenn wir das Modell darunter austauschen. Und das werden wir, denn Open-Weight-Modelle werden abgekündigt und überholt.

Überschreitest du das Kontextfenster einer Stufe, bekommst du eine 400 mit dem Maximum darin: Wir kürzen deinen Prompt nie stillschweigend.

Streaming-Antworten

Streaming funktioniert, wie du es erwartest, mit einem wichtigen Unterschied, den du kennen musst, weil es um dein Geld geht.

stream = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Schreib eine Zusammenfassung."}],
    stream=True,
    # Ohne das gibt es kein usage-Objekt und du siehst die Kosten nicht.
    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:                      # letzter Chunk
        print("\n", chunk.usage)

Brichst du einen Stream mittendrin ab, zahlst du nur, was bis dahin generiert wurde. Kommt wegen der abgebrochenen Verbindung kein Usage-Chunk an, schätzen wir den Verbrauch und korrigieren ihn beim täglichen Abgleich mit unserem Anbieter. Bis dahin steht eine solche Zeile in deiner Nutzungsübersicht als estimated.

Function Calling und Tool Use

Tools folgen dem bekannten Schema. Erzeugt ein Modell einen Tool Call, der nicht zu deinem Schema passt, protokollieren wir ihn: In Version 1 korrigieren wir ihn nicht stillschweigend, denn eine heimlich reparierte Ausgabe ist schlimmer als ein sichtbarer Fehler.

tools = [{
    "type": "function",
    "function": {
        "name": "find_invoice",
        "description": "Sucht eine Rechnung anhand ihrer Nummer.",
        "parameters": {
            "type": "object",
            "properties": {"number": {"type": "string"}},
            "required": ["number"],
        },
    },
}]

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

Structured Output mit einem JSON-Schema

Übergib ein JSON-Schema und validiere die Antwort auf deiner Seite. Unser Rat: immer validieren, auch wenn sich das Modell meistens benimmt.

resp = client.chat.completions.create(
    model="eu-standard",
    messages=[{"role": "user", "content": "Extrahiere Name und Betrag."}],
    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-Header: Kosten, Stufe und Routing

Jede Antwort sagt dir, was passiert ist. Das ist kein Debugging-Extra, sondern der Kern: Du kannst selbst prüfen, ob du bekommen hast, wofür du bezahlt hast.

Rate Limits und Ausgabengrenzen

Es gibt ein Limit pro Schlüssel und pro Konto, dazu die Grenzen, die du selbst festlegst. Letztere sind wichtiger, als es klingt: Ohne Grenze kann ein geleakter Schlüssel oder eine Endlosschleife in deinem eigenen Code ein Guthaben über Nacht leeren.

• Anfragen pro Minute, pro Schlüssel und pro Konto.
• Tages- und Monatsgrenze in Euro, pro Schlüssel einstellbar.
• Neue Konten: höchstens 25 € pro Tag in den ersten 48 Stunden, egal wie hoch das Guthaben ist.
• Sehen wir innerhalb einer Stunde mehr als das Zehnfache deines Wochendurchschnitts, pausieren wir den Schlüssel automatisch und schreiben dir eine E-Mail. Lieber ein Fehlalarm als ein leeres Konto.
• Eine Anfrage startet erst, wenn dein Guthaben mindestens 0,05 € beträgt.

Fehlercodes und was du tun kannst

Fehlgeschlagene Anfragen kosten dich nichts: Kam keine brauchbare Antwort zurück, geht nichts von deinem Guthaben ab.

Fair Use und Nutzungsrichtlinie

Wir lehnen Anleitungen für Waffen, Malware und Betrug ab, ebenso Material, das Kindern schadet. Diese Ablehnungen sind endgültig: Wir leiten eine solche Anfrage nie an ein anderes Modell weiter, um doch noch eine Antwort herauszuholen.

Etwas anderes ist es, wenn ein Modell eine legitime Frage zu Politik, Geschichte oder einem gesellschaftlich heiklen Thema ablehnt: Das behandeln wir als Mangel und schicken die Frage an ein Modell ohne diesen blinden Fleck. Du siehst das im Header X-EU-Routed: censorship.

Eines unserer Modelle ist mit einer eigenen Nutzungsrichtlinie lizenziert. Diese Richtlinie gilt uneingeschränkt: Umleiten hebelt keine Lizenzbedingungen aus.

Unsicher, ob dein Anwendungsfall passt? Schreib an hello@europeanailab.eu. Eine Antwort vorab ist für uns beide günstiger als ein gesperrter Schlüssel hinterher.

Häufige Fragen

Die Fragen, die per E-Mail kommen, bevor jemand einen Schlüssel erstellt: womit die API kompatibel ist, was eine Anfrage kostet und wo sie läuft.

Eine bestehende Integration umzuziehen sind drei Zeilen: der Schlüssel, die Base URL und ein Stufenname. Die ganze Änderung und was sich nicht übertragen lässt, steht in Wechseln in drei Zeilen. Noch Fragen? Die Tarife pro Stufe findest du auf der Preisseite, Modell und Lizenz hinter jeder Stufe unter KI-Transparenz und was bei einem Ausfall passiert auf der Statusseite. Zwei längere Texte: was eine KI-API pro Token kostet und wohin deine Prompts wirklich gehen.