Entwickler

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_request400

    The request was malformed or failed validation.

  • invalid_token401

    The credential is missing, malformed, expired, or revoked.

  • insufficient_scope403

    The credential is valid but lacks the scope this operation needs.

  • not_found404

    The requested resource does not exist.

  • method_not_allowed405

    That HTTP method is not supported on this path.

  • conflict409

    The request conflicts with the current state of the resource.

  • payload_too_large413

    The uploaded file exceeds the size limit.

  • unsupported_media_type415

    The file format is not supported.

  • insufficient_credits402

    The account has no credits left for this operation.

  • rate_limited429

    Too many requests. Retry after the interval in the Retry-After header.

  • upstream_failure502

    A provider SpeakNotes depends on failed.

  • content_policy422

    The content was refused by the AI content policy.

  • internal_error500

    SpeakNotes 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.