openclip-transcription

OpenClip : transcription

transcribe convertit un fichier vidéo ou audio en une transcription horodatée. C'est GRATUIT, il nécessite un compte OpenClip mais pas d'abonnement ni de crédits. Formats de sortie : JSON (structuré, avec horodatages), SRT et VTT.

Configuration (une fois)

OpenClip est un serveur MCP distant à l'adresse https://openclip.app/mcp. Connectez-vous avec votre compte OpenClip lorsque l'invite OAuth apparaît, il n'y a pas de clé API à copier.

• Claude Code : claude mcp add --transport http openclip https://openclip.app/mcp, puis /mcp pour autoriser.
• Claude Desktop / web : Paramètres, Connecteurs, « Ajouter un connecteur personnalisé », collez l'URL, connectez-vous.
• Cursor (.cursor/mcp.json) : { "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• Clients uniquement en-tête : générez un jeton MCP sur openclip.app/settings/connect et connectez-vous à https://openclip.app/mcp/key avec Authorization: Bearer <token>.

Vérification : appelez get_account.

Le processus

1. Téléchargement. create_upload(filename, content_type) renvoie un id et une upload_url. Envoyez les octets bruts en PUT vers upload_url, puis passez l'id comme video. N'appelez PAS complete_upload, cela lance le pipeline de clipping payant. Les outils gratuits lisent directement le fichier téléchargé. Les vidéos déjà dans list_videos fonctionnent également comme entrées.
2. Transcription. transcribe(video, language?, diarize?).
   • language - omettez pour détection automatique. Définissez-le lorsque vous connaissez déjà la langue et souhaitez éviter qu'un clip court ou bruyant soit mal détecté.
   • diarize - par défaut à true, étiquette qui parle. Désactivez-le pour un audio mono-locuteur afin de garder la sortie propre.
3. Interrogation. Renvoie un hashid tool_job. Interrogez get_tool_job_status(tool_job) toutes les 5 à 10 secondes. queued / processing sont en cours, completed renvoie les URL CDN permanentes des outputs (un par format : json, srt, vtt), failed renvoie error. La plupart des tâches se terminent en une minute ou deux.
4. Lecture de la sortie. Récupérez la sortie JSON pour un travail programmatique (segments avec heures de début et de fin, étiquettes de locuteur). Donnez à l'utilisateur l'URL SRT ou VTT lorsqu'il souhaite un fichier de sous-titres.

Deux outils de transcription différents

Ne les confondez pas :

• transcribe - l'outil GRATUIT. Fonctionne sur tout fichier que vous téléchargez. Cette compétence.
• get_transcript - lit la transcription d'une vidéo qui est déjà passée par le pipeline de clipping PAYANT. Prend en charge les fenêtres start_ms / end_ms au niveau de la phrase ou du mot. Utilisez-le lorsque vous avez déjà un job_id de clipping, pas pour un nouveau téléchargement.

Règles

• Interrogez toujours. La transcription est asynchrone, elle ne renvoie jamais le texte de manière synchrone.
• Les temps sont en millisecondes.
• Les URL de sortie sont des liens CDN permanents, ni signés ni expirant.
• L'utilisation gratuite est limitée en débit par jour avec un plafond de taille par fichier. Le texte d'erreur explique comment lever une limite.

Exemples d'invites à actions

• « Transcrire cette interview » - create_upload, PUT les octets, transcribe(video), interroger, renvoyer la transcription.
• « J'ai besoin d'un SRT pour cette vidéo » - pareil, puis renvoyer l'URL de sortie srt.
• « Qui a dit quoi dans cet enregistrement de réunion ? » - transcribe(video, diarize=true), interroger, lire la sortie JSON et regrouper les segments par locuteur.
• « Extraire les meilleures citations de ce discours » - transcrire, interroger, lire le JSON, puis sélectionner les citations avec leurs codes temporels.
• « C'est en néerlandais, transcris-le » - transcribe(video, language="nl"), interroger.

Connexe

Pour ensuite couper la vidéo à ces codes temporels, voir openclip-video-editing (edit_video avec operation="trim"). Pour trouver automatiquement les moments qui méritent d'être coupés, voir openclip-clipping.