AiVideoEditor
Kostenlos starten
Menü

Geprüft am 2026-11-10 · API-Version 2026-11-09 · Markdown lesen

Fehler, Wiederholungen und Wiederherstellung

API-Fehler verwenden { "error": { "code": "…", "message": "…", "requestId": "…" } } mit optionalen Feldfehlern, Zielfehlern, Wiederholungshinweisen und Aktionsübergaben. Bewahre requestId für den Support auf. Logge keine Zugangsdaten, signierten Upload-URLs oder sensiblen Anfrageinhalte, wenn du Diagnostik sammelst.

AntwortWiederherstellung
401 unauthenticatedPrüfe fehlenden, fehlerhaften oder widerrufenen Produktkey
403 forbidden_scope / account_not_allowedPrüfe Key-Scopes und Zielzugriff
402 account_limit, seat_limit, storage_limitPrüfe Arbeitsbereichs-Berechtigungen und Ressourcennutzung
402 subscription_inactive / trial_expiredBehebe den Abrechnungsstatus; bewahre Entwürfe und eingereihte Arbeit auf
409 revision_conflictLies die aktuelle Version, prüfe Änderungen und wende sie bewusst erneut an
409 idempotency_conflictDer Key wurde mit einem anderen Body wiederverwendet; stimme die ursprüngliche Operation ab
409 consent_requiredBitte eine autorisierte Person, die bereitgestellte Prüfungsübergabe abzuschließen
409 too_late_to_cancelPrüfe den tatsächlichen Zustellungsstatus; behaupte nicht, der Abbruch sei erfolgreich gewesen
media_expired / media_deletingLade Originale erneut hoch und aktualisiere den Entwurf
422 validation_failedKorrigiere strukturierte Felder oder Probleme pro Ziel
429 rate_limitedBeachte Retry-After; reduziere Nebenläufigkeit und verwende Backoff
submission_unknownStimme das vorhandene externe Ergebnis ab, bevor du eine weitere Übermittlung versuchst

Sichere Mutations-Wiederholungen

Erzeuge einen Idempotency-Key vor der ersten Mutation und speichere ihre exakte Anfrage. Wenn die Antwort verloren geht, kann die Operation bereits erfolgreich gewesen sein. Wiederhole die gleiche Anfrage mit demselben Key; erzeuge niemals einen neuen Key nur, weil das Netzwerk einen Timeout hatte. Mutierende MCP-Tools geben ihren Key zurück, auch bei transport_outcome_unknown-Fehlern. Der Adapter wiederholt Mutationen nicht automatisch.

Technische Geschwindigkeitsbegrenzungen des Arbeitsbereichs sind keine Posting-Guthaben. Verwende /usage für den aktuellen Plan und Rate-Informationen. Warte nur bei vorübergehenden Fehlern angemessen ab; Autorisierungs-, Validierungs- oder Zustimmungsfehler ohne Änderung ihrer Ursache erneut zu wiederholen, hilft nicht.

Teilerfolg und Beobachtung

Ein angenommener Publish-/Schedule-Batch ist eine Menge unabhängiger Zustellungen. Bewahre erfolgreiche Belege und native Links auf. Stelle ein fehlgeschlagenes Ziel über seinen eigenen Retry-Endpunkt wieder her, statt den ganzen Batch erneut zu erstellen. Bevorzuge signierte Webhooks; falls Polling, verwende eine begrenzte Anzahl von Versuchen mit zunehmenden Verzögerungen und leite ungelöste Arbeit an eine Person weiter.