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 pour développeurs 550W permet à un serveur de soumettre 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; les résultats doivent être vérifiés.

Traitement des sous-titres et filigranes vidéo

Pour la vidéo, téléversez un fichier MP4 ou MOV avec /open/uploadVideo, ou transmettez une videoUrl publique à /open/submitTask. Fournissez les dimensions, la durée et le rectangle à traiter. Vérifiez 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 jusqu’à 50 Mo. L’appel peut retourner un résultat ou une tâche à consulter plus tard. L’API ne télécharge pas de vidéos filigranées à partir de liens; évitez de promettre cette fonction.

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

S'authentifier et télécharger

Soumettez /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 cadre. Protect (mode=protect) conserve l’intérieur et traite l’extérieur; ce n’est pas un mode de meilleure qualité. Utilisez removeAudio seulement si vous devez retirer l’audio 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 HTTP(S) 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 règles d’entrée de l’API peuvent différer de celles de l’éditeur web. Consultez la documentation à jour et validez le format, la durée, les dimensions, la profondeur de couleur et le HDR avant une soumission payante.

Valider avant de dépenser des crédits

Le résultat dépend des détails et du mouvement autour du texte. Un ciel ou un mur uni se retouche généralement plus facilement que des mains, des cheveux, des vêtements à motifs ou des reflets. Regardez toute la vidéo, 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 contiennent code et message. Une tâche peut aussi inclure status, resultUrl et, si elle échoue, failCode, failReason et refundStatus. Réessayez les erreurs temporaires avec des délais croissants; corrigez d’abord les paramètres, formats ou crédits en cause.

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.