Fehler und Idempotenz
Standardfehler, Wiederholungen, Limits und Duplikatschutz.
Fehler verwenden application/problem+json, echten HTTP-Status und request_id.
Erstellungen brauchen einen 8–128 Zeichen langen Idempotency-Key. Gespeichert werden nur HMAC und Anfragefingerabdruck. Gleicher Key/Body liefert die ursprüngliche Aufgabe; anderer Body 409 idempotency_conflict; laufende Anfrage 409 request_in_progress. Bei automatischen Wiederholungen keinen neuen Key erzeugen.
Häufige Codes: invalid_api_key, invalid_api_key_rate_limited, api_key_expired, insufficient_scope, validation_error, unsupported_model, unsupported_parameter, input_url_not_allowed, insufficient_credits, payment_required, account_suspended, network_not_allowed, rate_limit_exceeded, concurrency_limit_exceeded, provider_unavailable, service_unavailable.
Wiederholte ungültige Zugangsdaten derselben IP werden ebenfalls begrenzt; gespeichert wird nur ein per Pepper HMAC geschützter IP-Fingerabdruck.
Netzwerkfehler, 429, 503 mit Backoff, gleichem Body und Key wiederholen. Ist das Provider-Ergebnis unklar, verweigert die API blindes erneutes Senden.
Vor einem erneuten Versuch immer den Header Retry-After beachten.