API de transcription YouTube pour les vidéos et les Shorts

Intégrez la conversion de YouTube en texte à des bases de connaissances, produits éducatifs et processus multimédias. Envoyez l’URL d’une vidéo publique, d’un Short ou un lien youtu.be, puis interrogez l’emplacement de la tâche pour obtenir des résultats structurés.

Créer du texte consultable à partir de médias YouTube

Fast Transcriber génère une transcription au moyen de son propre pipeline de traitement des médias et de reconnaissance vocale. Votre application n’a donc pas à dépendre d’une piste de sous-titres fournie par le créateur. Le texte et les segments terminés utilisent le même format que toutes les autres tâches de l’API.

Choisir la bonne URL pour une vidéo ou un Short YouTube public

Vidéos standard : youtube.com/watch?v={video-id} est la forme canonique d’une vidéo publique ordinaire.
Shorts : youtube.com/shorts/{video-id} désigne un Short public sans qu’il soit nécessaire de convertir d’abord son URL en lien watch.
Liens de partage compacts : les liens youtu.be/{video-id} utilisent le même pipeline après la résolution de la redirection. Envoyez une seule vidéo et non une page de playlist.

Démarrage rapide : mettre en file d’attente la transcription de une vidéo ou un Short YouTube public

Créez une clé d’API Fast Transcriber et conservez-la dans une variable d’environnement côté serveur. Envoyez l’URL publique du média dans source_url. N’exposez jamais la clé Bearer dans le code du navigateur et ne l’enregistrez pas dans le dépôt du code source.

curl --request POST https://fast-transcriber.com/api/v1/transcriptions \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "speaker_diarization": false
  }'

Une requête valide renvoie 202 Accepted. Cela signifie que la tâche a été mise en file d’attente, et non que la source a bien été récupérée. Lisez l’en-tête de réponse Location, affectez ce chemin à LOCATION_PATH, puis interrogez-le jusqu’à ce que l’état de la tâche soit completed ou failed.

LOCATION_PATH="/api/v1/transcriptions/95c3fdd8-..."
curl --request GET "https://fast-transcriber.com$LOCATION_PATH" \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN"

Prêt à envoyer cette requête ? Créez une clé d’API ou consultez tous les points de terminaison dans la documentation de l’API.

Exploiter le texte et les segments horodatés

Les tâches terminées contiennent le texte de la transcription et les segments horodatés disponibles selon les limites de l’offre du compte authentifié. Grâce à ce format de réponse commun, une application peut indexer une vidéo, accéder directement aux passages cités, créer des résumés ou transmettre la transcription à un processus de recherche ou de génération augmentée par récupération autorisé.

{
  "data": {
    "id": "95c3fdd8-...",
    "filename": "video-source.mp4",
    "status": "completed",
    "duration_seconds": 84,
    "text": "Texte intégral de la transcription...",
    "segments": [
      { "start": 0, "end": 3.8, "text": "Premier segment..." }
    ]
  }
}

Définissez speaker_diarization sur true lorsque vous avez besoin d’identifier les intervenants. La diarisation nécessite un compte Pro et utilise les mêmes limites que l’application web.

Ce que les développeurs créent à partir des transcriptions de une vidéo ou un Short YouTube public

Bases de connaissances : indexez des vidéothèques éducatives ou d’entreprise autorisées selon leur contenu parlé.
Outils de recherche : recherchez et citez les passages pertinents à l’aide des décalages temporels des segments.
Processus de publication : transformez vos propres vidéos en brouillons d’articles, notes d’émission, chapitres ou textes accessibles à relire.

Liens pris en charge et conditions d’accès

Les vidéos YouTube publiques, Shorts et liens youtu.be compatibles peuvent être envoyés dans source_url.

La vidéo doit être publique, disponible et accessible sans connexion.
Les vidéos privées, réservées aux membres, supprimées, soumises à une limite d’âge et les diffusions en direct actives ne peuvent pas être importées.
Envoyez l’URL canonique de la vidéo, du Short ou le lien youtu.be, puis gérez les erreurs d’inaccessibilité du média dans votre application.

Si un enregistrement est privé et que vous êtes autorisé à le traiter, récupérez le média au moyen de votre propre processus authentifié, puis utilisez l’API d’import direct de fichiers audio et vidéo.

Résoudre les problèmes d’import de une vidéo ou un Short YouTube public

Exclure les diffusions en direct actives : attendez la fin de la diffusion et la mise à disposition d’une rediffusion publique avant de mettre la transcription en file d’attente.
Tester la lecture sans compte : les vidéos réservées aux membres, privées, soumises à une limite d’âge et certaines vidéos limitées par région ne peuvent pas être récupérées par un processus de liens publics.
Conserver l’identifiant de la vidéo : cet identifiant stable aide votre application à dédupliquer les variantes watch, Shorts et youtu.be qui désignent le même média.

Prévoir les erreurs asynchrones

Une intégration en production doit gérer les sources non valides ou inaccessibles, les échecs d’authentification, les limites du compte et les défaillances temporaires du traitement. Les erreurs HTTP immédiates utilisent l’enveloppe {"error":{"code":"...","message":"..."}}. Lors de l’interrogation, une source déjà mise en file d’attente peut ensuite renvoyer data.status avec la valeur failed et des précisions dans data.error. Ne relancez pas indéfiniment un média privé, supprimé ou protégé par une connexion : affichez un message clair ou proposez l’import autorisé d’un fichier.

Questions fréquentes

Quels formats d’URL YouTube fonctionnent ?

Les vidéos publiques, les Shorts et les liens youtu.be compatibles utilisent le même résolveur que l’outil Fast Transcriber dans le navigateur.

L’API peut-elle accéder à un contenu YouTube privé ?

Non. Les sources par URL doivent être accessibles publiquement. Pour un média privé que vous êtes autorisé à traiter, utilisez l’import direct autorisé.

Pourquoi le point de terminaison renvoie-t-il 202 ?

La transcription est asynchrone. Utilisez l’en-tête Location pour récupérer l’état de la tâche, puis son résultat final.