API Video Eraser pour traiter les sous-titres et filigranes vidéo et image

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

L’API développeur 550W permet à un serveur d’envoyer des tâches autorisées de traitement de sous-titres ou de filigrane visible dans un rectangle sélectionné, ainsi que de filigranes d’images. L’accès à l’API n’accorde aucun droit sur les sources et les résultats doivent être vérifiés.

Traitement des sous-titres et filigranes vidéo

Pour la vidéo, chargez un fichier MP4 ou MOV avec /open/uploadVideo, ou transmettez une videoUrl publique à /open/submitTask. Indiquez les dimensions, la durée et le rectangle à traiter. Suivez ensuite la tâche asynchrone avec /open/taskDetail ou /open/taskList.

Suppression de filigranes d'images

Pour les images, /open/removeImageWatermark accepte les fichiers JPG, PNG, BMP, WebP, AVIF, TIFF et SVG de 50 Mo au maximum. L’appel peut renvoyer un résultat ou une tâche à consulter plus tard. L’API ne télécharge pas de vidéos marquées à partir de liens : ne présentez pas cette fonction comme disponible.

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 HTTP(S) publiquement accessible.

Authentification et téléchargement

Envoyez /open/submitTask avec width, height, duration et x1, y1, x2, y2. Le mode Standard (mode=normal, par défaut) traite la zone à l’intérieur du rectangle. Protect (mode=protect) préserve l’intérieur et traite l’extérieur ; ce n’est pas un réglage de qualité supérieure. Activez removeAudio uniquement si le son 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 HTTP(S) 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 règles d’entrée de l’API peuvent différer de celles de l’éditeur web. Vérifiez la documentation en vigueur, puis contrôlez le format, la durée, les dimensions, la profondeur de couleur et le HDR avant de soumettre un fichier payant.

Valider avant de dépenser des crédits

Le rendu dépend des détails et du mouvement autour du texte. Un ciel ou un mur uni se prête généralement mieux à la retouche que des mains, des cheveux, des tissus à motifs ou des reflets. Contrôlez toute la vidéo, pas seulement une vignette.

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 contiennent code et message. Les tâches peuvent aussi fournir status, resultUrl et, en cas d’échec, failCode, failReason et refundStatus. Réessayez les erreurs passagères avec des délais croissants ; corrigez d’abord les paramètres invalides, les formats refusés et les problèmes de crédit.

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.