API Video Eraser : suppression de sous-titres et filigranes

Ce que l'API développeur 550W supporte réellement

L'API développeur 550W permet à un backend de soumettre des tâches de suppression de sous-titres ou de texte vidéo et des tâches de suppression de filigranes d'images sans envoyer les utilisateurs dans un éditeur manuel. Elle est conçue pour les plateformes de créateurs, les pipelines de localisation, les bibliothèques multimédias et les outils internes qui traitent régulièrement du contenu que l'organisation possède ou est autorisée à modifier.

Suppression de sous-titres et de texte vidéo

Pour les vidéos, soumettez des fichiers MP4 ou MOV via /open/uploadVideo ou fournissez une videoUrl publique à /open/submitTask. La requête inclut les dimensions de la vidéo, la durée et le rectangle à réparer. Les tâches vidéo s'exécutent de manière asynchrone et peuvent être vérifiées via /open/taskDetail ou /open/taskList.

Suppression de filigranes d'images

Pour les images, /open/removeImageWatermark accepte les fichiers JPG, PNG, BMP, WebP, AVIF, TIFF ou SVG jusqu'à 50 Mo. Il peut attendre un résultat ou retourner une tâche de traitement pour une consultation ultérieure. L'API développeur Eraser n'expose pas le téléchargement de filigranes à partir de liens vidéo, donc les intégrations ne devraient pas promettre cette fonctionnalité.

Utilisez l'API pour le nettoyage autorisé de sous-titres/texte vidéo et la suppression de filigranes d'images ; gardez les flux de travail de filigranes de liens vidéo non supportés hors de vos promesses produit.

Un flux de requêtes prêt pour la production

Chaque requête est authentifiée avec userNo et apiKey. Gardez les deux valeurs sur votre serveur : placer une clé API dans du code de navigateur ou de client mobile la rend récupérable par les utilisateurs et les extensions. Une vidéo peut être téléchargée d'abord ou fournie sous forme d'URL HTTPS publiquement accessible.

S'authentifier et télécharger

Soumettez /open/submitTask avec width, height, duration et x1, y1, x2, y2. Un rectangle serré préserve généralement plus de détails qu'une réparation plein écran. Utilisez mode=protect lorsque le flux de travail supporté nécessite une reconstruction conservative, et removeAudio seulement lorsque l'audio doit être supprimé avant le traitement.

Soumettre une tâche idempotente

Envoyez un Idempotency-Key de 128 caractères maximum pour une création sécurisée en cas de nouvelle tentative. Si une connexion tombe après la soumission, réessayez avec la même clé au lieu de créer une deuxième tâche facturable. Stockez le taskId retourné à côté de votre propre ID d'actif.

Recevoir et vérifier le résultat

Pour la livraison asynchrone, fournissez une callbackUrl HTTPS publique. Le webhook se déclenche lorsque la tâche atteint un état final. Votre gestionnaire devrait accuser rapidement réception, vérifier à nouveau la tâche via /open/taskDetail et traiter la livraison répétée du webhook comme normale. L'interrogation reste utile comme chemin de récupération lorsqu'un rappel est retardé.

Les identifiants côté serveur, l'idempotence, les ID de tâches durables et la vérification des webhooks rendent les nouvelles tentatives sécurisées et observables.

Limites d'entrée et contrôles de qualité

Les vidéos téléchargées supportent le MP4 et le MOV, une taille de fichier maximale de 1 Go, une durée jusqu'à 600 secondes et un traitement jusqu'à 1080p dans les règles de dimensions documentées. Validez le format, la durée, les dimensions, la profondeur de bits et le statut HDR avant de soumettre afin que les médias non supportés n'entrent jamais dans la file payante.

Valider avant de dépenser des crédits

La qualité dépend de ce qui bouge derrière le sous-titre ou le texte. Les murs plats, le ciel et les paysages qui changent lentement sont généralement plus faciles que les mains, les cheveux, les vêtements à motifs, les reflets ou les mouvements rapides de caméra. Construisez une file d'examen pour les cas limites et comparez toute la chronologie, pas seulement une miniature.

Examiner les séquences difficiles

Les tâches d'images supportent les formats web et de design courants et coûtent un nombre fixe de crédits par tâche réussie selon la page API actuelle. Préservez le fichier source et enregistrez le résultat comme un dérivé ; la suppression de filigrane ne crée pas de droit d'auteur ou de permission d'utilisation commerciale.

Rejetez tôt les entrées non supportées et exigez un examen humain chaque fois que la zone de réparation croise un détail mobile important.

Facturation, échecs et politique de nouvelles tentatives

La suppression de sous-titres vidéo est facturée selon la durée et la résolution. Le barème actuel est de 1,3 crédit par seconde à 720p ou moins et de 1,6 crédit par seconde au-dessus de 720p jusqu'à 1080p. Une vidéo de 30 secondes en 1280×720 coûte donc environ 39 crédits, tandis qu'une vidéo de 30 secondes en 1920×1080 coûte environ 48 crédits. Interrogez /open/queryCredits avant d'accepter un grand lot.

Estimer le coût avant la soumission

Les réponses réussies incluent code et message ; les réponses de tâche exposent en plus status et, une fois terminées, resultUrl. Les tâches échouées peuvent inclure failCode, failReason et refundStatus. Réessayez les échecs de transport ou internes temporaires avec un backoff exponentiel, mais ne réessayez pas aveuglément les paramètres invalides, les médias non supportés, les comptes suspendus ou les erreurs de crédit insuffisant.

Gérer les champs d'échec stables

Enregistrez la latence de soumission, la latence de complétion, le taux d'échec, le taux de rejet d'examen et le coût par actif approuvé. Ces métriques révèlent si l'automatisation améliore le flux de travail au lieu de simplement déplacer le travail manuel en aval.

Une intégration utile mesure la sortie approuvée et le coût effectif, pas seulement les réponses HTTP réussies.

Lancer l'intégration en quatre étapes

Premièrement, générez une clé API à partir de la page développeur 550W localisée et soumettez une vidéo représentative. Deuxièmement, implémentez la consultation de tâches et affichez les états d'attente, de traitement, de succès et d'échec dans votre propre produit. Troisièmement, ajoutez l'idempotence et un webhook avec récupération par interrogation. Enfin, exécutez un lot contrôlé et examinez chaque sortie avant d'augmenter la concurrence.

Piloter avant de mettre à l'échelle

Utilisez des contrôles de développement et de production séparés, faites tourner les identifiants exposés, restreignez l'accès aux médias sources et maintenez une politique de suppression des résultats. Les équipes avec des critères d'acceptation clairs peuvent ensuite connecter l'API à un DAM, CMS, une file de localisation ou un flux de travail de téléchargement de créateurs sans sacrifier l'examen éditorial.