Gesamte Antwort lesen
Speichern Sie bei einem erfolglosen Status HTTP-Code, Header, Fehlertext und Anfrage-ID, nachdem Sie Geheimnisse entfernt haben. Diese Angaben unterscheiden eine ungültige Anfrage von einer Zugriffsablehnung oder einem vorübergehenden Problem.
Zeigen Sie eine unverarbeitete Dienstantwort nicht als einzige Benutzernachricht an: Erklären Sie die Aktion und bewahren Sie zugleich Diagnosedetails für einen Betreiber auf.
curl --include --request POST https://cicora.ai/api/v1/chat/completions \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"openai/gpt-5.6-sol","messages":[]}'Fehler klassifizieren
- 4xx erfordert in der Regel eine Korrektur von Schlüssel, Eingabedaten oder Zugriff.
- Bei 429 muss das Grenzwertfenster eingehalten und eine aggressive Wiederholung vermieden werden.
- Bei 5xx- und Netzwerkfehlern sind begrenzte Wiederholungsversuche mit exponentiellem Backoff und Jitter erforderlich.
Sicher wiederholen
Wiederholen Sie nur vorübergehende Fehler und nur dann, wenn der Vorgang in Ihrem Produkt idempotent ist. Behalten Sie für eine Generierung eine Client-Anfrage-ID, um doppelte Abrechnung oder ein doppeltes Artefakt zu verhindern.
Unterscheiden Sie beim Streaming zwischen einem Fehler vor dem ersten Delta und einem Abbruch nach einer Teilausgabe: Letztere kann nicht unbemerkt durch eine neue Antwort ersetzt werden.