SpeakNotes API-Fehlercodes
Jeder Fehler gibt denselben JSON-Umschlag zurück: einen stabilen Code, eine für Menschen lesbare Nachricht, einen Link zu dieser Seite und die fehlerhaften Felder, falls vorhanden.
Die Struktur
Fehler werden niemals als HTML zurückgegeben. Der Code ist stabil und sicher für die Programmierung; die Nachricht kann sich jederzeit ändern.
HTTP/1.1 402 Payment Required
X-Request-Id: 0f0a3f2c-6f1e-4a5e-9f1b-9d0b5a2c7e11
{
"error": {
"type": "billing_error",
"code": "insufficient_credits",
"message": "This operation costs 14 credits and the account has 3 left.",
"doc_url": "https://speaknotes.io/developers/errors#insufficient_credits",
"request_id": "0f0a3f2c-6f1e-4a5e-9f1b-9d0b5a2c7e11"
}
}Codes
invalid_request400The request was malformed or failed validation.
invalid_token401The credential is missing, malformed, expired, or revoked.
insufficient_scope403The credential is valid but lacks the scope this operation needs.
not_found404The requested resource does not exist.
method_not_allowed405That HTTP method is not supported on this path.
conflict409The request conflicts with the current state of the resource.
payload_too_large413The uploaded file exceeds the size limit.
unsupported_media_type415The file format is not supported.
insufficient_credits402The account has no credits left for this operation.
rate_limited429Too many requests. Retry after the interval in the Retry-After header.
upstream_failure502A provider SpeakNotes depends on failed.
content_policy422The content was refused by the AI content policy.
internal_error500SpeakNotes failed to process the request.
Was sollte wiederholt werden
Wiederholen Sie rate_limited nach dem Intervall in Retry-After und upstream_failure ein- oder zweimal mit Backoff. Wiederholen Sie niemals invalid_request, insufficient_scope oder content_policy ohne Änderungen: Diese werden jedes Mal auf die gleiche Weise fehlschlagen.
Request-IDs
Jede Antwort enthält einen X-Request-Id-Header, und Fehler-Bodies wiederholen diesen. Geben Sie diese ID beim Support an, um den genauen Fehlerfall zu finden.