Auf dieser Seite
Häufige Fehler
Fehler, auf die jedes Agent-Tool beim Verbinden mit HiAPI stoßen kann, und wie du sie behebst.
Jede Tool-Anleitung listet nur die Fehler auf, die für dieses Tool spezifisch sind. Die folgenden können bei jedem Tool auftreten. Prüfe zuerst den Statuscode oder das Schlüsselwort in der Fehlermeldung und schlage ihn dann in der Tabelle unten nach:
| Fehler | Ursache | Behebung |
|---|---|---|
| 401 / invalid api key | Der Key ist unvollständig, hat Leerzeichen davor oder danach, oder du hast den maskierten Anzeigewert kopiert | Öffne API Keys, klicke auf das Kopiersymbol und kopiere den vollständigen HiAPI API-Key erneut |
| Der Fehler nennt Guthaben, Kontingent oder ein Ausgabenlimit | Das Guthaben des Kontos ist zu niedrig, oder das Ausgabenlimit dieses Keys ist aufgebraucht | Lade unter Kontoguthaben auf oder erhöhe das Ausgabenlimit dieses Keys auf der Seite API Keys |
| 403 | Dieser Key hat keine Berechtigung für das Modell | Prüfe Gruppe und Berechtigungen des Keys, siehe Authentifizierung |
| 404 / model not available | Die Base URL hat ein überzähliges oder fehlendes /v1, oder der Modellname ist falsch geschrieben | Prüfe die URL anhand von Base URL & Protokolle; kopiere den Modellnamen aus der Liste der Textmodelle |
| 400 does not support this endpoint | Das im Tool gewählte Protokoll wird von diesem Modell nicht unterstützt | Probiere ein anderes Protokoll (zum Beispiel Anthropic Messages für Claude) oder wechsle zu einem anderen Modell |
| 400 stream must be true / endloses Laden | Das Modell unterstützt nur Streaming, und das Tool hat eine Anfrage ohne Streaming gesendet | Aktiviere Streaming im Tool. Wenn die Schaltfläche „Prüfen” oder „Verbindung testen” des Tools diesen Fehler zurückgibt, ignoriere ihn und gehe nach einem echten Chat |
| 429 | Zu viele Anfragen oder zu hohe Parallelität | Warte und versuche es erneut, und führe weniger Aufgaben gleichzeitig aus; wenn der Fehler ein Kontingent nennt, folge der Zeile „Guthaben, Kontingent” oben |
| 500 / 502 / 503 | Der Modelldienst ist vorübergehend ausgefallen | Warte ein bis zwei Minuten und versuche es erneut; wenn es weiterhin auftritt, probiere zuerst ein anderes Modell und kontaktiere uns dann |
| Timeout / unterbrochene Antwort | Das Netzwerk oder ein Proxy hat die langlebige Verbindung blockiert | Prüfe Netzwerk und Proxy-Regeln für api.hiapi.ai und versuche es dann erneut |
Vor einem erneuten Versuch das Anfrageprotokoll prüfen
Eine Agent-Aufgabe kann auf dem Server bereits abgeschlossen sein, während nur die Verbindung des Tools abgebrochen ist. Prüfe vor einem erneuten Versuch im Anfrageprotokoll, ob diese Anfrage erfolgreich war und wie viel sie gekostet hat, damit du nicht zweimal für dieselbe Arbeit zahlst.
Weiterhin Probleme
Reiche unter Kontakt ein Ticket mit den folgenden Angaben ein; das hilft uns, das Problem schneller zu lokalisieren:
- Die Uhrzeit des Fehlers (auf die Minute genau)
- Das verwendete Tool und seine Version, zum Beispiel Claude Code 2.1.284
- Der Modellname und die Base URL
- Der ursprüngliche Fehlertext oder ein Screenshot
Maskiere den API-Key vor einem Screenshot und sende den Key niemals an jemanden, auch nicht an den Support.