Fehlerdiagnose und Wiederherstellung
Unklaren Übermittlungsstatus, Preiskonflikte, Upload-Fehler und unterbrochene Streams gezielt untersuchen.
Nachvollziehbare Informationen sichern
Notieren Sie Zeitpunkt, Endpunkt, HTTP-Status, Anwendungscode, request_id und eine erhaltene taskId. Unterscheiden Sie zwischen einer ausdrücklichen Ablehnung, einer ausbleibenden Netzwerkantwort und einem Fehler nach Annahme. API-Schlüssel, vollständige Prompts und Originaldateien gehören nicht in allgemeine Logs oder Supportanfragen.
Modell fehlt oder ist nicht verfügbar
Laden Sie den authentifizierten Katalog neu und prüfen Sie enabled, available sowie die genaue Modell-ID der Aufgabe. Eine öffentliche Modellseite belegt keine Aufrufberechtigung. Bei anhaltendem 50301 Verfügbarkeit erneut prüfen und Wiederholungen begrenzen. Wiederholte Anfragen schalten kein Modell frei.
Ungültige Eingabe oder Angebotskonflikt
Bei 400 Typen, Wertebereiche und bedingte Pflichtfelder im aktuellen inputSchema prüfen und nicht unterstützte Parameter entfernen. Fordern Sie bei 40901 eine neue Kostenschätzung an und lassen Sie sie bestätigen: Eingabe, Gültigkeit oder Preis haben sich geändert. Gewöhnliche 409 sind operationsabhängig. Ein Schlüssel mit anderem Payload benötigt eine korrigierte Zuordnung im eigenen System.
Timeout ohne Aufgaben-ID
Ursprünglichen Payload und Idempotency-Key behalten. Innerhalb des gültigen Fensters dieselbe Übermittlung wiederherstellen, bevor eine neue angelegt wird. Mit taskId anschließend recordInfo lesen. Client-Timeouts, geschlossene Tabs und getrennte Streams stornieren keine angenommenen Aufgaben. state, cost und settled bestimmen das Ergebnis.
Upload erfolgreich, Datei dennoch abgelehnt
Nach dem PUT ist files/{fileId}/commit erforderlich. Die zurückgegebene spicy:// URI in einem unterstützten Eingabefeld verwenden, niemals uploadUrl. Signierten Content-Type, Größe, Format, Eigentümerkonto und Ablauf prüfen. Uploads bleiben einen Tag erhalten; ein erneuter Versuch kann einen neuen Upload und geänderte Eingaben erfordern.
Callback fehlt oder Download abgelaufen
HTTPS-Empfänger, Signaturprüfung über Originalbytes und schnelle Erfolgsantwort prüfen. Den Zustand über recordInfo abgleichen und Callbacks vor der Auftragsausführung deduplizieren. Solange das Ergebnis gespeichert ist, eine neue Download-URL anfordern. Bei pending später wiederholen; unavailable oder abgelaufene Ergebnisse lassen sich nicht durch Aktualisieren der alten URL wiederherstellen.
Stream endet vorzeitig
Vor dem SSE-Parser HTTP-Status und Content-Type prüfen. TCP-Fragmente sind keine vollständigen Ereignisse, ein Verbindungsende kein Erfolgsnachweis. Abschlussereignisse, Fehler und Zeitlimits prüfen. Nach Trennung weder Erstattung noch kostenlose Wiederholung voraussetzen; request_id behalten und Nutzungsdaten prüfen.
Guthaben, Limits und Support
Bei 40201 verfügbares Guthaben, bei 40202 Ausgabenlimits für Konto und Schlüssel prüfen. Bei 429 Retry-After beachten und Anfragen reduzieren. Niemals Schlüssel an den Support senden. Schritte, Zeit, Anfrage-IDs, bereinigte Feldstruktur sowie erwartetes und tatsächliches Ergebnis angeben.
Weitere Anleitungen
Fehler und Wiederholungen · Idempotenz · Medien hoch- und herunterladen · Text und Streaming