API: Fehler und Grenzen
Fehlercodes
| Symptom |
Ursache |
Lösung |
| HTTP 401 |
Kein Authorization-Header angekommen |
Authorization: Bearer <API-Key> mitsenden |
| HTTP 400 |
Ungültige Anfrage, z. B. encoding_format fehlt bei Embeddings, oder falscher Key |
Anfrage und Key prüfen |
| HTTP 403 |
Anfrage kommt nicht von einer freigegebenen IP-Adresse (NAT, Proxy, anderer Host) oder falscher Pfad |
Ausgehende IP prüfen: curl https://ifconfig.me |
| HTTP 429 |
Kosten-Deckel oder Durchsatzgrenze erreicht |
Anfragen drosseln, Eingaben kürzen, ggf. Deckel anpassen lassen |
| SSL-Handshake bricht ab |
IP-Adresse statt Hostname, oder der Client sendet kein SNI |
Immer den Hostnamen aus der Übergabe verwenden. Zertifikatsprüfung abschalten hilft nicht. |
| SSL-Fehler unter PowerShell 5.1 / altem .NET |
Server akzeptiert nur TLS 1.2 und 1.3 |
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 |
| Zertifikat „nicht vertrauenswürdig“ |
Eine Firewall bricht TLS in Ihrem Netz auf |
Aussteller prüfen: Er muss Let's Encrypt sein |
Bleibt der Fehler: Senden Sie dem Support die exakte Fehlermeldung mit Uhrzeit, nicht „SSL-Fehler“.
Grenzen
| Thema |
Regel |
| Durchsatz |
Anfragen und Token pro Minute sind je Key bzw. Modell begrenzt. Ihre Werte stehen in der Übergabe. |
| Lasttests |
Vorher bei GBC ansagen. Die GPUs teilen sich mehrere Kunden. |
| Kosten-Deckel |
Optional je Key, mit Rücksetzung jeden Monat. Bei Erreichen: HTTP 429. |
| Speicherung |
GBC speichert über die API keine Chat-Verläufe. |
| Daten |
Personenbezogene Echtdaten erst nach Abschluss der Auftragsverarbeitung (AVV) |