API: Schnellstart¶

In fünf Minuten zur ersten Antwort.

1. Key als Umgebungsvariable setzen¶

Linux / macOSWindows PowerShell

export GBCAI_API_KEY="<Ihr API-Key>"
export GBCAI_BASE_URL="<API-Adresse aus Ihrer Übergabe>"

$env:GBCAI_API_KEY = "<Ihr API-Key>"
$env:GBCAI_BASE_URL = "<API-Adresse aus Ihrer Übergabe>"

2. Modelle abfragen¶

curl "$GBCAI_BASE_URL/models" -H "Authorization: Bearer $GBCAI_API_KEY"

→ Die Antwort listet die Modell-IDs, die Ihr Key nutzen darf.

3. Erste Chat-Anfrage¶

curlPython (OpenAI-SDK)

curl "$GBCAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $GBCAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<Modell-ID>","messages":[{"role":"user","content":"Hallo"}]}'

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["GBCAI_BASE_URL"],
    api_key=os.environ["GBCAI_API_KEY"],
)
r = client.chat.completions.create(
    model="<Modell-ID>",
    messages=[{"role": "user", "content": "Hallo"}],
)
print(r.choices[0].message.content)

4. Kosten je Endkunde zuordnen (optional)¶

Setzen Sie das Feld user mit einer eindeutigen Kennung Ihres Endkunden. GBC weist den Verbrauch dann zusätzlich je Kennung aus.

client.chat.completions.create(model="<Modell-ID>", messages=[...], user="kunde-4711")

Praxis-Tipps¶

Tipp	Warum
Vorfiltern statt Volldump	Relevante Ausschnitte statt ganzer Dateien. Das Token-Limit pro Minute greift sonst sofort.
Pseudonymisieren	Namen und Mailadressen vor dem Versand ersetzen. Die Aufgabe braucht sie fast nie.
Belege verlangen	Lassen Sie sich die Quelle bzw. die Belegzeile mitliefern. So prüfen Sie die Antwort in Sekunden.
`temperature` niedrig (0,1–0,3)	Für Analyse und Extraktion: stabilere Antworten