Fehlerbehandlung & Antwortschema

OneASR gibt Standard-HTTP-Statuscodes zusammen mit OpenAI-kompatiblen JSON-Fehlerobjekten zurück.

---

Fehlerantwortformat

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

---

Häufige HTTP-Statuscodes

Statuscode	Code / Typ	Beschreibung
200 OK	-	Anfrage erfolgreich ausgeführt.
400 Bad Request	invalid_request_error	Erforderliche Parameter fehlen oder nicht unterstütztes Audioformat.
401 Unauthorized	invalid_api_key	Fehlender oder ungültiger API-Schlüssel im Authorization-Header.
404 Not Found	not_found_error	Die angeforderte Aufgaben-ID oder das Modell wurde nicht gefunden.
422 Unprocessable	validation_error	Validierung des Multipart-Formularschemas fehlgeschlagen.
500 Internal Server	server_error	ASR-Inferenz-Worker-Fehler oder Out-of-Memory-Ausnahme.