API 550W pour supprimer 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 de suppression de filigranes d'images sans faire passer les utilisateurs par un éditeur manuel. Elle est conçue pour les plateformes de créateurs, les pipelines de localisation, les médiathèques 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 texte vidéo

Pour la vidéo, 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 des 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 consultation ultérieure. L'API développeur Eraser n'expose pas le téléchargement de filigranes de liens vidéo, les intégrations ne doivent donc pas promettre cette fonctionnalité.

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

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

Chaque requête est authentifiée avec userNo et apiKey. Conservez ces deux valeurs sur votre serveur : placer une clé API dans du code client navigateur ou 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.

Authentification et téléchargement

Soumettez /open/submitTask avec width, height, duration, 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 uniquement 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ûre 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 doit 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 callback est retardé.

Les identifiants côté serveur, l'idempotence, les IDs de tâches persistants et la vérification du webhook rendent les nouvelles tentatives sûres 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 la soumission 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 se déplace 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. Créez une file d'attente d'examen pour les cas limites et comparez toute la timeline, pas seulement une miniature.

Examiner les images difficiles

Les tâches d'images supportent les formats web et 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 du filigrane ne crée pas de permission de droit d'auteur ou d'utilisation commerciale.

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

Facturation, échecs et politique de nouvelle tentative

La suppression de sous-titres vidéo est facturée par durée et 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 lot important.

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é, resultUrl. Les tâches échouées peuvent inclure failCode, failReason et refundStatus. Réessayez les échecs de transport ou internes temporaires avec 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édits insuffisants.

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 production approuvée et le coût effectif, pas seulement les réponses HTTP réussies.

Lancez 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âche 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 d'attente de localisation ou un flux de travail de téléchargement de créateur sans sacrifier l'examen éditorial.