Fehler und Wiederholungen
Was jeder Status bedeutet und was zu tun ist.
Fehler sind JSON mit einem detail-Feld. Verwende Status und Retry-Header; behalte detail für Protokolle und Hinweise.
| Status | Bedeutung | Was tun |
|---|---|---|
400 | Ungültige Eingabe, unbekannte Engine oder falsches Routing | Anfrage korrigieren oder verfügbare Engine wählen |
401 | PIN oder API-Schlüssel fehlt oder ist falsch | Zugangsdaten senden |
403 | Der Aufrufer darf eine lokale oder administrative Route nicht verwenden | Loopback oder eine erlaubte Route nutzen |
409 | Ein erforderliches Modell oder ein Zustand fehlt | Empfohlenes Modell installieren oder Konflikt beheben |
422 | Der Request-Body ist ungültig | Feldnamen, Typen oder Wertebereiche korrigieren |
429 | Die GPU-Warteschlange ist voll | Retry-After abwarten und erneut versuchen |
500 | Unerwarteter Engine- oder Serverfehler | detail protokollieren; nur erneut versuchen, wenn es sicher ist |
503 | Engine-Laden oder Generierung kurzzeitig nicht verfügbar | Retry-After beachten |
504 | Eine geschützte Transkription oder Generierung hat das Zeitlimit überschritten | Einmal erneut versuchen; bei Wiederholung die Aufgabe verkürzen |
Wiederholen
Wiederhole 429, wiederholbare 503 und 504 mit begrenztem exponentiellem Backoff. VoiceStudio kann senden:
Retry-After: 30
X-OmniVoice-Retryable: trueWiederhole 400, 401, 403 oder 422 nicht automatisch. Bei 409 muss zuerst ein Modell installiert oder eine andere ausdrückliche Änderung vorgenommen werden.
Setze Synchronisations- und Stapelaufträge nach einem Verbindungsabbruch anhand des Jobstatus fort, statt Medien erneut hochzuladen.