AiVideoEditor
Commencez gratuitement
Menu

Vérifié le 2026-11-10 · Version API 2026-11-09 · Lire le Markdown

Erreurs, tentatives et récupération

Les erreurs d'API utilisent { "error": { "code": "…", "message": "…", "requestId": "…" } } avec des erreurs de champs, des erreurs de destination, des indices de retry et des handoffs d'action optionnels. Conservez requestId pour le support. Ne journalisez pas les identifiants, les URL de téléversement signées ni le contenu sensible des requêtes lors de la collecte de diagnostics.

RéponseRécupération
401 unauthenticatedVérifiez une clé de produit manquante, malformée ou révoquée
403 forbidden_scope / account_not_allowedExaminez les scopes de la clé et l'accès aux destinations
402 account_limit, seat_limit, storage_limitExaminez les droits de l'espace de travail et l'utilisation des ressources
402 subscription_inactive / trial_expiredRésolvez l'état de facturation ; préservez les brouillons et le travail en file
409 revision_conflictLisez la version actuelle, examinez les changements et réappliquez intentionnellement
409 idempotency_conflictLa clé a été réutilisée avec un corps différent ; réconciliez l'opération d'origine
409 consent_requiredDemandez à une personne autorisée de compléter le handoff de revue fourni
409 too_late_to_cancelInspectez le statut réel de la livraison ; ne prétendez pas que l'annulation a réussi
media_expired / media_deletingRetéléversez les originaux et mettez à jour le brouillon
422 validation_failedCorrigez les champs structurés ou les problèmes par destination
429 rate_limitedRespectez Retry-After ; réduisez la concurrence et utilisez un backoff
submission_unknownRéconciliez le résultat externe existant avant de tenter une autre soumission

Tentatives sûres de mutation

Générez une clé d'idempotence avant la première mutation et stockez sa requête exacte. Si la réponse est perdue, l'opération a peut-être déjà réussi. Rejouez la même requête avec la même clé ; ne générez jamais une nouvelle clé simplement parce que le réseau a expiré. Les outils de mutation MCP renvoient leur clé en écho, y compris dans les échecs transport_outcome_unknown. L'adaptateur ne retente pas automatiquement les mutations.

Les limites techniques de vitesse de l'espace de travail ne sont pas des crédits de publication. Utilisez /usage pour le plan actuel et les informations de débit. Ralentissez pour les erreurs transitoires uniquement quand c'est approprié ; retenter des erreurs d'autorisation, de validation ou de consentement humain sans changer leur cause ne sert à rien.

Succès partiel et observation

Un lot de publication/planification accepté est un ensemble de livraisons indépendantes. Conservez les reçus réussis et les liens natifs. Récupérez une destination en échec via son propre point de terminaison de retry au lieu de recréer tout le lot. Préférez les webhooks signés ; en cas de polling, utilisez un nombre borné de tentatives avec des délais croissants et remontez le travail non résolu à une personne.