Une transcription avec horodatage pour retrouver vos citations
Demandez format=text avec timestamps=true. Si vous avez activé l’identification des locuteurs, leurs étiquettes apparaissent aussi. La référence de lecture liste les paramètres.
Une ligne renvoie à un segment de l’enregistrement. Gardez le lien source ou le nom du fichier avec le texte : 00:12:40 ne sert à rien si personne ne sait quelle vidéo ouvrir. L’exemple montre le format d’export, avec un texte d’illustration.
Dans le JSON, les temps sont des secondes écoulées depuis le début du fichier, pas une heure de la journée. Votre lecteur peut s’en servir pour ouvrir le bon passage ; vos notes peuvent garder les mêmes valeurs comme références.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text×tamps=true" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
[00:00:00] Place the microphone near the speaker.
[00:00:04] Record a short test before the interview.Créer un fichier VTT ou choisir le SRT ?
Le SRT contient des sous-titres numérotés avec un début et une fin. Le WebVTT commence par WEBVTT et s’utilise avec l’élément HTML track. Une fois la transcription terminée, demandez format=srt ou format=vtt et enregistrez la réponse.
Choisissez le format accepté par votre outil. Le SRT est courant dans les logiciels de montage et les imports de sous-titres. Le WebVTT convient à une piste de sous-titres HTML. Ni l’un ni l’autre n’incruste le texte dans l’image : le lecteur ou l’éditeur décide de son apparence.
En SRT, les millisecondes sont séparées par une virgule ; en WebVTT, par un point. Renommer l’extension ne convertit pas le fichier. Demandez plutôt l’autre format avec le même ID : cette lecture ne consomme pas de nouvelles minutes.
1
00:00:00,000 --> 00:00:04,200
Place the microphone near the speaker.
2
00:00:04,200 --> 00:00:09,800
Record a short test before the interview.Pour surligner les mots ou préparer une coupe précise
Ajoutez include=words à la lecture JSON pour obtenir les horodatages par mot lorsqu’ils sont disponibles. Sinon, words vaut null. Consultez les champs de la réponse avant de construire votre affichage.
La transcription par IA fournit le début, la fin et la confiance de chaque mot. Les sous-titres YouTube générés automatiquement donnent les débuts ; les fins sont déduites du mot suivant. Les sous-titres du créateur sur YouTube et toutes les pistes des autres plateformes restent au niveau des segments, même quand elles sont automatiques. Pour X, transcript_source vaut x_captions.
Prévoyez donc un affichage par segment si les mots ne sont pas disponibles. Pour un clip, écoutez autour de la coupe : un horodatage n’est pas forcément un bon point de montage. Pour des sous-titres, regroupez les mots en phrases lisibles et vérifiez-les à la taille de l’écran visé.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?include=words" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"Vérifiez le fichier dans le lecteur prévu
Attendez status=completed avant d’enregistrer un export SRT, VTT ou texte. Tant que le traitement continue, l’API renvoie l’objet JSON avec son état. Si votre lecteur refuse un fichier, vérifiez d’abord que vous n’avez pas enregistré ce JSON sous une extension .srt.
Les sous-titres suivent le fichier envoyé. Si vous coupez le début ou gardez un extrait, recalez les temps sur le montage final. Pour réutiliser une vidéo, conservez les plages des extraits envisagés, puis ajustez les sous-titres après le montage.
Avant de publier, regardez la vidéo à vitesse normale avec ses sous-titres : longueur des lignes, temps de lecture et présentation des locuteurs. Le guide d’accessibilité couvre aussi les sons importants et le contexte visuel que la transcription des paroles ne fournit pas.
Gardez l’ID de la transcription avec vos fichiers. Pour obtenir du WebVTT au lieu du SRT, ou du JSON détaillé au lieu du texte, relisez ce même ID. Inutile de renvoyer l’enregistrement.