Skip to main content
Obtenir le statut de la traduction

Obtenir le statut de la traduction

Récupérez le statut actuel d’un projet de traduction. Utilisez ce point de terminaison pour interroger la progression et obtenir l’URL de la vidéo traduite une fois le traitement terminé.

Requête

En-têtes

string
requis
Votre clé API VoiceCheap. Obtenez-en une sur app.voicecheap.ai/page-api.

Paramètres de chemin

string
requis
L’identifiant unique du projet de traduction renvoyé par le point de terminaison Start Translation.

Réponse

La structure de la réponse varie en fonction du statut de la traduction.

Champs communs

string
requis
L’identifiant unique du projet
string
requis
Le nom du projet
string
requis
URL du fichier vidéo/audio original téléchargé
string
requis
La langue originale détectée ou spécifiée
string
requis
La langue cible pour la traduction
number
requis
Durée du contenu en secondes
number
requis
Horodatage Unix de création du projet
string
requis
Flux de travail API ayant créé le projet : translation ou transcription.
string
requis
Statut de la transcription source : processing, success ou failed. Ce signal est indépendant de l’achèvement du doublage.
object
requis
Transcriptions normalisées disponibles.
string
Identifiant de travail de traduction pour la version traduite actuellement rapportée.
string
Identifiant de version traduite pour la version traduite actuellement rapportée.
string
Étape actuelle du projet. Pendant la création ou la transcription, cela reflète l’étape de création active. Les exemples incluent downloading_content, content_validation et transcription_processing. Une fois le doublage lancé, il peut passer à une étape de doublage active telle que smart_sync ou audio_assembling. status: processing ne s’associe pas avec actualProgressStep: done.
number
Pourcentage de progression approximatif pour la création/transcription du projet (0-100)
string
Étape de doublage actuelle pour la langue cible (par ex. smart_sync, audio_enhancement, video_upload)
number
Pourcentage de progression approximatif pour le doublage (0-100)
string
requis
Statut actuel de la traduction : processing, success ou failed

Champs Lip Sync

Lorsque la synchronisation labiale a été demandée, la réponse inclut un objet lipSync supplémentaire :
object
Statut et détails de sortie de la synchronisation labiale (présents uniquement lorsque la synchronisation labiale a été demandée)
Lorsqu’une synchronisation labiale est demandée, la traduction reste dans processing jusqu’à ce que lipSync.status soit COMPLETED. Si la synchronisation labiale échoue, le statut devient failed et error.code est LIPSYNC_FAILED. Lorsque la synchronisation labiale réussit, lisez l’élément synchronisé depuis lipSync.videoUrl ; translatedVideoUrl est la sortie vidéo traduite avant la superposition de la synchronisation labiale.
Utilisez GET /v1/projects/{projectId} lorsque vous avez besoin de l’historique complet des versions traduites ou de l’historique complet de la synchronisation labiale.

Champs de réponse en cas de succès

Pour les flux de travail de traduction, les champs suivants sont inclus lorsque status est success. Un flux de travail de transcription seule atteint success sans champs de média traduits.
string
URL pour télécharger le fichier vidéo traduit
string
URL pour télécharger le fichier audio traduit séparément

Champs de réponse en cas d’échec

Lorsque status est failed, le champ supplémentaire suivant est inclus :
object
Détails de l’erreur

Exemples

Exemples de réponse

Statut de traitement

Statut de traitement (Lip Sync demandé)

Statut de succès

Statut de succès (Lip Sync terminé)

Statut d’échec

Bonnes pratiques d’interrogation

Intervalle d’interrogation recommandé : 10-30 secondesLe temps de traduction varie en fonction de la durée et de la complexité de la vidéo. Pour une vidéo typique de 2 minutes, prévoyez 2 à 5 minutes de temps de traitement.
Limite de débit : 30 requêtes par minuteÉvitez d’interroger plus d’une fois toutes les 2 secondes pour rester dans les limites de débit.

Erreurs