Traduire une vidéo YouTube pendant la transcription
Ajoutez translate_to, un code ISO 639-1 à deux lettres, à la requête qui crée la transcription. wait attend aussi la traduction. Le guide de la traduction couvre les imports et le MCP.
La transcription est créée comme d'habitude, à partir de l'audio parlé ou des sous-titres de la plateforme. La traduction s'exécute ensuite sur ce texte : l'original existe donc toujours et reste lisible, même si la traduction n'est pas encore prête.
Une seule langue cible est acceptée par requête. Pour une autre langue, traduisez de nouveau la même transcription une fois terminée.
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'Traduire une transcription existante
Envoyez la langue en POST à la transcription. L'API répond 202 avec le statut de la traduction. Interrogez la transcription ou utilisez un webhook. Les codes de statut sont décrits dans Traduction.
La transcription doit être terminée, sinon l'API renvoie transcript_not_ready. Répéter la requête est sans risque : une traduction en cours ou terminée est renvoyée telle quelle, et une traduction en échec est relancée.
Les webhooks envoient transcription.translation.completed ou transcription.translation.failed, votre application n'a donc pas besoin d'interroger l'API en boucle.
curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en"}'Sous-titres bilingues, traduction seule ou original
Ajoutez translation=both, only ou none à GET /v1/transcriptions/:id ou à un téléchargement texte, SRT ou VTT. La valeur par défaut est both.
Avec both, les segments JSON portent un champ translation, le texte place la ligne traduite sous l'originale et chaque bloc SRT ou VTT a deux lignes. Avec only, le texte traduit remplace l'original, avec les mêmes horodatages et locuteurs.
La réponse contient aussi un objet translation avec la langue et un statut : processing, completed ou failed. Lire un autre format d'une transcription terminée ne consomme pas de minutes supplémentaires.
| translation | Ce que vous obtenez |
|---|---|
| both | Le texte d'origine et sa traduction ensemble, une paire par segment ou bloc. |
| only | Le texte traduit à la place de l'original, avec le même minutage. |
| none | La transcription d'origine uniquement. |
Ce que fait la traduction, et ce qu'elle ne fait pas
Il s'agit d'une traduction automatique du texte de la transcription. Vérifiez les noms, les termes techniques et les citations avant de publier, et gardez la transcription d'origine pour comparer.
transcript1 ne double pas une vidéo et ne traduit pas la voix. Il n'y a pas d'audio traduit, et les sous-titres ne sont pas incrustés dans la vidéo. Vous recevez du texte et des fichiers de sous-titres à utiliser dans votre éditeur ou votre lecteur.
La traduction ne coûte aucune minute. Les minutes de transcription s'appliquent comme d'habitude, et une traduction en échec ne fait pas échouer la transcription ni ne la rembourse.