Comment faire transcrire de l’audio et de la vidéo par Claude Code ?
Ajoutez le serveur MCP de KolWrite avec une seule commande, claude mcp add, ou installez la skill kolwrite-transcribe. Claude Code envoie alors votre fichier, lance le job, attend le résultat et écrit la transcription, les sous-titres ou la traduction dans votre projet. La facturation se fait à la seconde, sur vos crédits KolWrite.
Obtenir une clé API Démarrage rapide Langues prises en charge
Ce que vous faites une seule fois
Créez le compte et la clé vous-même sur console.kolwrite.com : inscrivez-vous, ajoutez des crédits, ouvrez API Keys et créez une clé. Un agent ne peut pas le faire à votre place.
Placez la clé dans le fichier de profil de votre shell (~/.zshrc, ~/.bashrc) pour que chaque session d’agent que vous lancez puisse la lire, puis ouvrez un nouveau terminal :
export KOLWRITE_API_KEY=... # paste the key from API Keys
Les outils lisent la clé uniquement dans cette variable. Ne la collez pas dans un chat et ne la committez pas dans un dépôt.
Ajouter le serveur MCP
Lancez la commande dans un terminal où KOLWRITE_API_KEY est définie. Ajoutez --scope user pour l’avoir dans tous vos projets :
claude mcp add --transport stdio --env KOLWRITE_API_KEY="$KOLWRITE_API_KEY" kolwrite -- npx -y https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz
Le serveur donne à l’agent six outils : transcribe_file, transcribe_url, upload_file, get_job, list_models, list_languages. Il s’exécute sur votre ordinateur avec Node.js 18 ou une version plus récente et se télécharge depuis https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca).
Vérifiez avec claude mcp list, ou avec /mcp dans une session.
Ou installer la skill
La skill est un dossier contenant un SKILL.md et le client en un seul fichier. Claude Code la charge depuis ~/.claude/skills (tous les projets) ou .claude/skills (un projet) et l’utilise quand vous demandez une transcription :
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip && rm kolwrite-transcribe.zip
Le texte de la skill est dans SKILL.md. Utilisez le serveur MCP ou la skill, pas besoin des deux.
Que lui demander
Trois demandes à essayer avec Claude Code :
Transcris ~/Downloads/interview.m4a avec KolWrite et enregistre le texte dans interview.txt à côté du fichier.
Génère des sous-titres SRT en anglais pour talk.mp4 avec KolWrite, un sous-titre par phrase.
Qui a dit quoi dans team-call.mp3 ? Transcris-le avec identification des locuteurs sur le modèle oracle, puis liste les actions à mener pour chaque intervenant.
Claude Code a besoin du fichier sur votre ordinateur ou d’un lien direct vers un fichier média. Pour une vidéo de plus de 100 MiB environ, il extrait d’abord l’audio avec ffmpeg.
Combien ça coûte
| Tâche | Modèle | Coût |
|---|---|---|
| Un entretien de 30 minutes, texte brut | base | 0,24 US$ |
| Une réunion d’une heure avec identification des locuteurs | oracle | 1,56 US$ |
| Une conférence d’une heure en hébreu avec sous-titres en anglais | oracle | 1,44 US$ |
| Une heure d’audio bruyant avec des voix qui se chevauchent | oracle_max | 3,60 US$ |
La facturation se fait à la seconde d’audio, sur vos crédits, sans minimum. L’identification des locuteurs ajoute 0,10 crédit par heure d’audio. Le serveur MCP et kolwrite.py utilisent base tant que vous ou l’agent n’indiquez pas un autre modèle, et oracle_mini pour traduire. Tous les tarifs : /fr/models.
Ce que l’agent ne doit pas faire
- Vous demander la clé dans le chat, l’afficher, ou l’écrire dans un fichier, une commande ou un commit.
- Relancer la même transcription après un timeout ou une erreur réseau. Chaque lancement crée un nouveau job facturé ; il doit plutôt vérifier le job existant ou vous demander.
- Saisir lui-même des horodatages. Pour couper ou citer à un moment précis, il reprend les numéros de segments de la transcription et calcule les temps dans le code à partir des horodatages des mots.
- Envoyer comme média l’adresse d’une vidéo YouTube ou d’une autre page web. Il lui faut le fichier média lui-même.
- Transcrire de longs enregistrements (plus d’une heure) sans vous indiquer d’abord le coût prévu.
Questions et réponses
Claude Code a-t-il besoin du serveur MCP, ou peut-il appeler l’API lui-même ?
Il peut appeler l’API REST lui-même avec curl ou Python si vous ajoutez à CLAUDE.md la consigne de agent-instructions.md. Le serveur MCP ou la skill lui évitent de réécrire à chaque fois le code d’envoi et de suivi.
Où va l’audio ?
Le fichier est envoyé à KolWrite et transcrit dans le cloud, selon les conditions d’utilisation et la politique de confidentialité de KolWrite. Le serveur MCP n’en garde aucune copie.