Référence API

Cette référence offre aux développeurs et aux agents d’automatisation un emplacement unique et compact où trouver les points de terminaison de l’API Weydub, les contrôles d’accès, la structure des requêtes, le comportement asynchrone, les règles de facturation et de conservation, ainsi que les signaux de dépannage.

Principes de base des requêtes

Certains noms d’infrastructure hérités peuvent encore apparaître dans des ressources de démonstration publiques ou d’anciens chemins de compte. Considérez cette documentation de l’API Weydub comme le contrat actuel de référence pour le produit.

Avant l’appel

Authentification

La plupart des requêtes utilisent des en-têtes :

Content-Type: application/json
AppKey: $WEYDUB_APP_KEY
AppSign: md5(md5(request_body) + $WEYDUB_APP_SECRET)

Signez exactement le corps JSON compact qui sera envoyé. Consultez Authentification et signature avant de diagnostiquer les échecs de signature.

Exception non signée :

POST /v-w-c/enum/query2

L’endpoint de requête des énumérations est utilisé pour les listes dynamiques de langues et de statuts et ne nécessite pas de signature.

Index des endpoints

Créer une tâche vidéo

POST /v-w-c/gateway/ve/work/free

Workflows courants utilisant cet endpoint :

Requête minimale :

{
  "urls": ["https://example.com/demo.mp4"],
  "needChineseOcclude": 1,
  "videoInpaintLang": "all",
  "callback": "https://your-domain.example/webhooks/weydub"
}

Champs généralement présents dans la réponse de création :

Interroger l’état d’une vidéo

POST /v-w-c/gateway/ve/work/status

{
  "idWorks": [488026661]
}

Valeurs d’état :

Les tâches vidéo réussies peuvent inclure videoUrl, coverUrl, srcSrtUrl, tgtSrtUrl, sourceVideoUrl, ttsMetaResult, wyVoiceParam ainsi que les métadonnées de la tâche.

Tâches d’image

Point de terminaison public actuel pour la création :

POST /v-w-c/gateway/ve/image/translate

Point de terminaison pour recommencer :

POST /v-w-c/gateway/ve/image/translate/redo

Requête de traduction d’image :

{
  "srcLang": "en",
  "tgtLang": "es",
  "translateOn": 1,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/product.png\",\"fileName\":\"product.png\",\"id\":12345,\"materialName\":\"product.png\"}",
  "app": "WD"
}

Requête de suppression de texte d’une image :

{
  "srcLang": "en",
  "tgtLang": "en",
  "translateOn": 0,
  "synthesisOn": 1,
  "commodityFilterOn": 0,
  "downloadInfo": "{\"url\":\"https://example.com/banner.png\",\"fileName\":\"banner.png\",\"id\":12346,\"materialName\":\"banner.png\"}",
  "app": "WD"
}

Lisez Traduction d’image avant d’implémenter des tâches d’image, car downloadInfo, downloadInfos et result pour recommencer doivent conserver la structure de chaîne documentée.

Interrogation des énumérations

POST /v-w-c/enum/query2

Ce point de terminaison ne nécessite pas AppSign.

{
  "text": "Lang"
}

Noms d’énumération courants :

Facturation, limites et conservation

Récapitulatif des callbacks

Incluez un callback URL dans les requêtes de création lorsque cette option est prise en charge. Weydub envoie directement l’élément de travail terminé à votre serveur, sans l’enveloppe externe code / msg / body utilisée par les réponses d’interrogation.

Règles de gestion des callbacks :

• Vérifiez Callback-Sign à l’aide du corps brut de la requête de callback et de votre AppSecret.
• Renvoyez HTTP 200 ainsi qu’un corps non vide uniquement une fois le stockage durable effectué avec succès.
• Rendez les gestionnaires idempotents en utilisant l’ID du travail ou de la tâche.
• Les callbacks échoués pour les tâches créées au cours des dernières 24 heures sont retentés environ toutes les 30 minutes.
• Si une nouvelle exécution modifie le contenu vidéo ou image, l’URL de sortie peut changer ; stockez l’URL du résultat le plus récent.

Consultez Modèle de tâche asynchrone pour plus de détails sur les callbacks.

Dépannage

Contrat de l’agent

Les agents d’automatisation doivent :

• Charger llms.txt et la compétence API de Weydub.
• Utiliser les scénarios de démonstration avant les médias des clients.
• Conserver les identifiants dans des variables d’environnement ou dans un gestionnaire de secrets.
• Enregistrer les identifiants avant de signaler la réussite aux utilisateurs.
• Modéliser les tâches comme submitted -> processing -> succeeded | failed | timed_out.
• Ne jamais exposer AppSecret ni inventer d’endpoints activés.