API: Überblick¶
Die GBC.ai-API ist OpenAI-kompatibel. Bestehender Code mit dem OpenAI-SDK läuft nach zwei Änderungen: Basis-Adresse und API-Key.
Endpunkte¶
| Endpunkt | Methode | Zweck |
|---|---|---|
/v1/models |
GET | Verfügbare Modelle abfragen |
/v1/chat/completions |
POST | Chat-Antworten |
/v1/embeddings |
POST | Texte vektorisieren, siehe Embeddings |
/v1/audio/transcriptions |
POST | Audio zu Text, siehe Transkription |
Kein Web-Interface, kein Admin-Zugang, keine Wissensdatenbank über die API.
Zugang¶
| Punkt | Regel |
|---|---|
| API-Adresse | Erhalten Sie bei der Einrichtung. Verwenden Sie immer den Hostnamen, nie eine IP-Adresse. |
| API-Key | Persönlich bzw. je Anwendung. GBC übergibt ihn telefonisch oder per Passwort-Safe, nie per Mail. |
| Freigegebene IP-Adressen | Zugriff nur von den vereinbarten Adressen. Alle anderen erhalten HTTP 403. |
| Kosten-Deckel | Optional je Key, mit Rücksetzung jeden Monat. Bei Erreichen: HTTP 429. |
| Modell-Allowlist | Optional je Key: nur die vereinbarten Modelle |
Key sicher aufbewahren¶
- Immer als Umgebungsvariable oder im Secret-Store
- Nie im Quellcode, nie im Repository, nie in Tickets oder Mails
- Leak-Verdacht? Sofort melden. GBC sperrt den Key und stellt einen neuen aus.
Weiter mit dem Schnellstart.