# Des transcriptions pour agents IA et pipelines LLM > Des transcriptions pour agents IA via MCP, SKILL.md ou API REST : liens vidéo et fichiers, texte horodaté à lire page par page. Canonical: https://transcript1.com/fr/use-cases/transcriptions-pour-agents-ia Language: fr Last updated: 2026-10-19 Récupérez des transcriptions pour agents IA à partir d’un lien vidéo ou d’un enregistrement. YouTube, X, TikTok, Instagram, Facebook ou Bluesky : votre agent reçoit du texte horodaté à parcourir, citer ou résumer. Connectez-le par MCP, avec l’Agent Skill ou par API REST. Les fichiers importés et les autres sources vidéo prises en charge suivent le même parcours. - 8 outils sur le serveur MCP - Un Agent Skill au format SKILL.md - Lecture par pages pour respecter la fenêtre de contexte ## Un agent qui récupère le texte et va jusqu’au bout ### Branchez votre client MCP Claude, ChatGPT, Cursor, VS Code et Claude Code peuvent appeler les outils sur https://api.transcript1.com/mcp. Le serveur accepte les clients MCP qui prennent en charge les connexions distantes. ### Donnez les bonnes consignes à l’agent Le fichier SKILL.md explique la connexion, les appels à effectuer et les doublons à éviter. llms.txt oriente l’agent vers la documentation de l’API. ### Lisez sans saturer le contexte Par défaut, MCP renvoie du texte avec un horodatage sur chaque ligne. Les longues transcriptions se lisent par pages, sans couper les segments. next_from_seconds indique où reprendre. ### Reprenez une transcription existante Avec un lien complet, transcribe réutilise une transcription correspondante des dernières 24 heures. Ce rapprochement ne fonctionne pas avec les liens courts. Si vous avez déjà l’ID, appelez get_transcription. ### Passez par REST pour vos traitements en série Votre pipeline peut utiliser la même API avec des webhooks de fin de traitement signés, des segments JSON et l’horodatage par mot. ## Lancez la transcription une fois, puis gardez son ID transcribe attend la transcription et en renvoie la première page. Si elle n’est pas encore prête, l’agent reçoit un id : il appelle ensuite get_transcription, sans soumettre à nouveau la vidéo. Les arguments figurent dans la [référence des outils MCP](https://transcript1.com/fr/docs/mcp#tools). Distinguez les appels qui lancent un travail de ceux qui le consultent. Créer une transcription peut consommer des minutes. Lire son état ou son texte ne relance pas le traitement. Enregistrez l’ID dans l’état persistant de la tâche : l’historique de conversation du modèle ne suffit pas si l’agent redémarre. Pour une liste de vidéos, conservez chaque lien à côté de son ID. Un lien complet permet de retrouver une transcription récente avec les mêmes options ; un lien court ne le permet pas au moment de l’envoi. Consulter un ID connu reste le moyen le plus direct d’éviter un doublon. L’exemple ci-dessous utilise un lien de publication vidéo publique Bluesky à remplacer. ### Appels des outils MCP ``` transcribe(url="[public bsky.app video-post URL]") get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", from_seconds=900) ``` ## Ajoutez les instructions à votre agent Les agents compatibles avec les skills peuvent découvrir transcript1 dans l’index, puis lire les instructions de SKILL.md. MCP fournit les outils à appeler. L’Agent Skill explique dans quel ordre les utiliser et comment réagir aux erreurs. Vous pouvez suivre le même cycle dans un pipeline REST, sans client MCP. Le fichier llms.txt sert de porte d’entrée vers la documentation : il ne récupère pas de transcription. Choisissez selon le contexte d’exécution. Un assistant interactif profite de la lecture par pages de MCP. Un service d’import en arrière-plan peut préférer REST et les webhooks signés. Les deux utilisent les mêmes limites de compte et la même réserve de minutes : comptez tous vos clients quand vous gérez les traitements simultanés. ### Index des skills et fichier SKILL.md ``` https://transcript1.com/.well-known/agent-skills/index.json https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md ``` ## Du texte horodaté pour votre pipeline LLM Récupérez le texte et ses horodatages, puis transmettez-les à votre modèle. La [documentation des exports](https://transcript1.com/fr/docs/api-reference#get-a-transcription) décrit l’appel ci-dessous. Avec MCP, lisez les longues transcriptions par pages. Pour des traitements REST en série, utilisez un [webhook](https://transcript1.com/fr/features/webhook-transcription). Gardez le lien source et les temps de début et de fin dans les données envoyées au modèle. Pour la recherche, stockez les extraits avec l’ID de la source et leurs repères temporels. Découpez aux limites des segments ou lors d’un changement de sujet, sans couper un mot ni une prise de parole. Le résumé ou l’extraction revient ensuite à votre assistant, pas à transcript1. Demandez-lui de distinguer les citations des reformulations et de signaler ce que la source ne dit pas. Une transcription de démonstration Instagram peut contenir « cliquez ici » sans nommer le bouton montré à l’écran : le modèle ne doit pas inventer cette information. ### cURL ``` curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text×tamps=true" \ -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" ``` ## Vérifiez que l’agent a tout lu Tant que next_from_seconds est présent, il reste du texte. Passez cette valeur comme from_seconds à l’appel suivant et notez les pages déjà lues. Une première page peut présenter le sujet sans contenir l’argument principal ni la conclusion. Un appel réussi ne suffit donc pas pour annoncer l’analyse de toute la vidéo. Sur un long enregistrement, recueillez les éléments de chaque page avant de rédiger la synthèse. Gardez les horodatages dans les notes intermédiaires et cherchez les nuances ou corrections apportées plus loin. Si vous comparez plusieurs vidéos, indiquez celles qui ont été lues et celles qui ont échoué. Une source indisponible ne vaut ni accord ni absence de preuve. - [Récupérer le texte d’une vidéo Bluesky](https://transcript1.com/fr/features/transcrire-video-bluesky) - [Ce que contient une transcription Instagram](https://transcript1.com/fr/features/transcription-instagram) ## Prévoyez les erreurs et l’envoi de fichiers Si la transcription est en cours, consultez à nouveau son statut. Si vous recevez login_required ou no_audio, il faut une autre source. Faites remonter cette différence à l’utilisateur ou au processus qui pilote l’agent. Ne remplacez jamais une erreur de source par une transcription vide : le modèle pourrait en déduire que personne n’a parlé. Pour un fichier local, l’environnement de l’agent doit pouvoir envoyer des données par HTTP. MCP prépare l’upload et le finalise, mais les octets passent par des appels PUT en dehors de MCP. Si l’assistant ne peut pas les effectuer, demandez à l’utilisateur d’importer le fichier dans le tableau de bord. L’agent pourra ensuite lire la transcription à partir de son ID. - [Outils MCP, lecture par pages et envoi de fichiers](https://transcript1.com/fr/docs/mcp) ## Questions fréquentes ### Avec quels agents puis-je l’utiliser ? Avec tout client MCP qui accepte les serveurs distants, notamment Claude, ChatGPT, Cursor, VS Code et Claude Code. Les agents capables de lire un fichier SKILL.md peuvent aussi utiliser l’Agent Skill de transcript1. ### Comment connecter l’agent à mon compte ? Claude et ChatGPT proposent une connexion OAuth. Pour les autres agents, créez une clé API commençant par t1_ et envoyez-la comme token Bearer. ### Que se passe-t-il si la transcription est très longue ? L’agent la lit par pages. Chaque page se termine à la fin d’un segment. Si du texte reste à lire, next_from_seconds donne la valeur à transmettre comme from_seconds pour continuer. ### Une nouvelle tentative peut-elle me coûter deux fois ? Avec un lien complet, transcribe réutilise une transcription de la même vidéo avec les mêmes options pendant 24 heures, sans nouvelle facturation. Ce rapprochement ne fonctionne pas avec les liens courts. Pour consulter un travail déjà lancé sans le recréer, utilisez get_transcription avec son ID. ### Claude peut-il résumer la vidéo à partir de ce texte ? Oui. transcript1 fournit la transcription par MCP, puis Claude rédige le résumé après l’avoir lue. Vous pouvez aussi transmettre le texte à votre propre pipeline LLM. transcript1 ne rédige pas le résumé. ## Pour aller plus loin - [Transcription par MCP](https://transcript1.com/fr/features/serveur-mcp-transcription) - [Serveur MCP (documentation)](https://transcript1.com/fr/docs/mcp) - [Webhooks](https://transcript1.com/fr/features/webhook-transcription) - [Transcription TikTok](https://transcript1.com/fr/features/transcription-tiktok)