W API Weydub

Documentation pour développeurs

API Weydub pour la localisation des médias, les développeurs et les agents d’automatisation.

Commencez par une requête signée, puis passez aux flux de travail de production pour la suppression de sous-titres et de texte, la traduction vidéo, l’extraction de sous-titres, la traduction d’images, les callbacks et l’automatisation. Les utilisateurs Weydub connectés peuvent activer gratuitement l’accès à l’API depuis Mon compte.

Activer gratuitement l’accès à l’API Gérer les clés API Exécuter la première requête Ouvrir la référence API Copier la documentation Markdown Ouvrir la compétence pour agents

Commencez par le démarrage rapide pour développeurs

Obtenez vos identifiants, effectuez un appel signé, vérifiez son état, puis choisissez la page du flux de travail. Cette méthode accélère le parcours humain tout en fournissant aux agents une structure suffisante pour développer en toute sécurité.

  1. Obtenir l’accèsConnectez-vous, activez gratuitement l’accès à l’API depuis Mon compte et confirmez les droits associés aux flux de travail de votre compte.
  2. Lire la référenceVérifiez les points de terminaison, les structures de requête, les champs d’état et les notes de dépannage.
  3. Exécuter le démarrage rapideCréez une tâche de démonstration avec des variables d’environnement et signez un JSON compact.
  4. Vérifier les résultatsInterrogez l’état ou recevez un rappel, puis conservez les URL de sortie et les erreurs.

Flux de travail principaux

La page d’accueil de l’API est centrée sur quatre tâches de production : supprimer le texte des vidéos, traduire des vidéos, extraire des fichiers de sous-titres et traduire des images.

01

Supprimer les sous-titres et le texte

Nettoyez les sous-titres incrustés, les légendes, les filigranes, les bandeaux inférieurs, les logos, les indices narratifs, les numéros d’enregistrement et le texte visible.

  • Point de terminaison : /v-w-c/gateway/ve/work/free
  • Basic : needChineseOcclude: 1|2|3
  • Lite/Pro : advanced_lite, advanced_large_box, advanced_full
  • Masques : videoInpaintMasks
  • CRF : extraOptions.write_options.crf lorsqu’il est activé
Lire la documentation API Essayer la suppression en ligne
02

Traduire une vidéo

Créez des sous-titres traduits, un doublage par IA facultatif et des ressources vidéo localisées générées.

  • Point de terminaison : /v-w-c/gateway/ve/work/free
  • Doublage : needWanyin: 1, wyTaskType: FULL
  • Texte à l’écran : needChineseOcclude: 11
  • Forte intensité émotionnelle : /voice/incorporate
Lire la documentation API Essayer la traduction vidéo
03

Extraire les sous-titres

Générez des fichiers SRT/VTT à partir des sous-titres visibles par OCR ou des dialogues parlés par ASR.

  • OCR : needChineseOcclude: 14
  • Masques OCR : type: trans_only_ocr
  • ASR : wyTaskType: ONLY_ASR, wyNeedText: 0
Lire la documentation API Essayer la génération de sous-titres
04

Traduire des images

Localisez des images de produits, des captures d’écran, des planches de bandes dessinées, des captures d’interface d’application et des ressources créatives.

  • Point de terminaison : /v-w-c/gateway/ve/image/translate
  • Traduire : translateOn: 1, synthesisOn: 1
  • Effacer le texte : translateOn: 0, synthesisOn: 1
Lire la documentation API Essayer la traduction d’images

Essayez d’abord dans Weydub

Lorsqu’un utilisateur veut voir la qualité du résultat avant l’implémentation, dirigez-le vers le flux de travail Weydub correspondant. La documentation de l’API reste dédiée à l’automatisation, à la signature, aux callbacks et au comportement en production.

Supprimer les sous-titres en ligneValidez le nettoyage des sous-titres et du texte dans l’application web. Traduire une vidéoVérifiez les sous-titres, le doublage et le résultat vidéo localisé. Générer des sous-titresTestez visuellement l’extraction de sous-titres par OCR ou à partir de la parole. Traduire une imageEssayez l’OCR, l’effacement, la traduction et la recomposition de la mise en page.

Règles de production

Ces règles sont intégrées aux pages de l’API afin que les développeurs et les agents puissent s’appuyer sur la documentation Weydub locale pendant l’implémentation.

Limites vidéoLes limites strictes actuelles sont de 15 minutes et 1 000 Mo par fichier vidéo. Divisez ou compressez la vidéo avant l’envoi.
Limites d’imageMaximum : 2 000 × 2 000 px et 50 Mo. Formats pris en charge : png, jpeg, jpg, bmp, WEBP. Les URL ne doivent pas contenir de caractères chinois.
FacturationLes tâches finales ayant échoué ne déduisent aucun crédit.
Fonctions de rappelVérifiez Callback-Sign. Renvoyez HTTP 200 ainsi qu’un corps non vide après avoir effectué un stockage durable. Les callbacks échoués sont réessayés pendant 24 heures, environ toutes les 30 minutes.

Deux publics

Cette documentation s’adresse aux personnes qui utilisent des outils de programmation IA ainsi qu’aux agents d’automatisation qui ont besoin d’un contrat compact et fiable.

Développeurs humains utilisant des outils de programmation IA Lisez la présentation, copiez le Markdown dans l’assistant de votre IDE, exécutez les scénarios de démonstration, puis transmettez les identifiants par des variables d’environnement.
Agents d’automatisation et bots internes Chargez la référence et la compétence destinées aux agents, créez des tâches asynchrones, stockez les identifiants de travail, gérez les callbacks de manière idempotente et n’exposez jamais AppSecret.

Lire dans l’ordre

Lisez d’abord les cinq tutoriels principaux. Utilisez les fichiers pour agents lorsqu’un outil de programmation IA ou un bot interne effectue l’implémentation.

Démarrage rapideFlux Python minimal pour créer et interroger une tâche de suppression de texte. Authentification et signatureAppKey, AppSign et la convention de double signature MD5. Suppression de sous-titresBasic, Advanced Lite/Pro, masques, CRF et charges utiles de suppression. Traduction vidéoTraduction de sous-titres, doublage, traduction du texte à l’écran et modes vocaux. Extraction de sous-titresExtraction de sous-titres par OCR et ASR avec gestion des tâches asynchrones. Référence APIIndex des points de terminaison, structure des requêtes, champs d’état et dépannage. Référence LLMFichier d’orientation court pour les assistants de programmation et les bots. Compétence API WeydubInstructions réutilisables pour Codex, Cursor, Claude Code et les agents internes.

Parcours d’intégration

Utilisez ceci comme liste de contrôle d’implémentation pour les scripts, les services backend, les passerelles sans code, les workers de file d’attente et les clients générés par IA.

  1. Accès gratuitActivez l’accès à l’API depuis Mon compte, puis confirmez les autorisations associées au compte pour le flux de travail cible.
  2. Stocker les secretsUtilisez WEYDUB_APP_KEY et WEYDUB_APP_SECRET ou un gestionnaire de secrets.
  3. Signer exactementJSON compact, signature double MD5, puis envoyez les mêmes octets dans le corps de la requête.
  4. Créer une tâcheEnvoyez les URL des médias et conservez les identifiants de projet, de travail et de tâche renvoyés.
  5. Attendre de manière fiableUtilisez les callbacks en production et l’interrogation périodique comme solution de secours.
  6. Stocker les résultatsConservez les URL de sortie, les liens SRT, les ressources d’image, l’état et les erreurs.
  7. Exécuter les démonstrationsVérifiez le fonctionnement avec les ressources officielles avant de connecter les médias des clients.
  8. Protéger les utilisateursRendez les nouvelles tentatives idempotentes et ne divulguez jamais AppSecret.

Structure minimale d’appel

Utilisez des variables d’environnement pour les identifiants. Ne stockez jamais AppSecret dans du code frontend, des dépôts publics, des captures d’écran, des journaux ou des invites susceptibles d’être conservées.

POST https://api.zhaoli.com/v-w-c/gateway/ve/work/free
Headers:
  Content-Type: application/json
  AppKey: $WEYDUB_APP_KEY
  AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

Body:
{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all"
}

Scénarios de démonstration

Utilisez ces ressources publiques pour vérifier une intégration API avant de connecter les médias des clients. Elles couvrent les flux de travail que Weydub attend le plus souvent des bots et des outils de programmation.

Scénario 1

Suppression avancée de texte

Envoyez une vidéo en anglais avec des sous-titres incrustés, en utilisant le modèle plein écran Advanced Pro.

 Scénario 2

Traduction vidéo

Traduisez la vidéo de démonstration en anglais vers l’espagnol, avec des sous-titres et un doublage par IA.

 Scénario 3

Clonage à forte intensité émotionnelle

Utilisez la vidéo chinoise et le fichier JSON associé pour un doublage du chinois vers l’anglais dans une mini-série courte.
  • Vidéo en anglais : http://gc9.cdn.izhaoli.cn/ghostcut_demo/TextRemoval_Dubbing_Eng.mp4
  • Vidéo chinoise : http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.mp4
  • JSON chinois : http://gc9.cdn.izhaoli.cn/ghostcut_demo/HighEmotion_Dubbing_cn2en.json

Copier au format Markdown

Ce bloc reprend la présentation du fichier index.md, afin qu’une personne puisse le coller dans une session de programmation IA et qu’un agent puisse l’analyser comme du Markdown brut.

Présentation de l’API Weydub Markdown prêt à l’emploi pour les outils de programmation et les agents d’automatisation.

Pour les outils de programmation IA

Fournissez à votre assistant les pages Démarrage rapide, Authentification, Suppression de sous-titres, Traduction vidéo, Extraction de sous-titres et Compétence API Weydub. Fournissez ensuite les identifiants uniquement par des variables d’environnement. Il s’agit du parcours prévu pour Codex, Cursor, Claude Code, les bots internes et les agents d’automatisation.

Lire la compétence pour agents Ouvrir la référence API Ouvrir llms.txt Fichier Skill au format Markdown brut Ouvrir la présentation Markdown

Aide et tutoriels

Les pages API locales constituent la référence pour l’implémentation. Pour obtenir de l’aide sur les flux de travail du produit, consultez le centre d’aide Weydub local.

Aide Weydub Règles de crédits et de facturation Téléchargement par lots Guide de Weydub Studio