Vocnu pour les développeurs
Le moteur de Vocnu est open source. La ligne de commande et le serveur MCP vous donnent accès au service hébergé depuis votre terminal et votre assistant AI, avec un jeton API personnel.
Moteur open source
La même chaîne de traitement que le service hébergé, sous AGPL-3.0 : reconnaissance vocale, traduction, synchronisation de la narration et mixage. Exécutez-la sur votre ordinateur avec vos propres clés OpenAI et ElevenLabs.
Ses fonctions
- Reconnaît la parole avec faster-whisper sur votre GPU ou CPU, en s’appuyant sur les pistes de sous-titres déjà présentes dans le fichier.
- Traduit avec OpenAI : analyse de la transcription complète, traduction par blocs avec contexte, révision indépendante et limite de caractères pour chaque ligne, afin qu’elle tienne dans le temps imparti.
- Lit le texte avec les voix ElevenLabs. Les répliques trop longues sont réenregistrées, reformulées plus brièvement, puis seulement accélérées, jusqu’à 1,08 fois au maximum.
- Mixe la voix off : le son original est atténué pendant chaque réplique, et les vidéos conservent l’audio original sur une seconde piste.
- Génère des vidéos MP4, MKV, MOV, WebM ou AVI avec sous-titres activables, de l’audio M4A, MP3, WAV, FLAC ou OGG et des sous-titres SRT, VTT et ASS.
- Écrit les noms des films et séries connus selon la graphie du répertoire des noms public.
Prérequis
- uv et ffmpeg. Tesseract est facultatif, pour les sous-titres sous forme d’images.
- Un GPU NVIDIA accélère considérablement la reconnaissance vocale ; le CPU fonctionne aussi, mais lentement.
- Vos propres clés OpenAI et ElevenLabs. Vous payez directement les fournisseurs : lors de nos essais, environ 0,05 à 0,10 USD par minute de parole. Un reçu indique les montants exacts.
uvx --from git+https://github.com/vocnu/engine \
vocnu-engine translate film.mkv --to frAGPL-3.0 : vous pouvez utiliser, modifier et partager le moteur. Si vous le proposez comme service réseau, vous devez partager vos modifications sous la même licence. Les remarques de locuteurs natifs sur leur langue comptent parmi les contributions les plus précieuses.
Ligne de commande
Le paquet npm vocnu, pour Node.js 20 ou version ultérieure. Il importe un fichier jusqu’à 10 Go, affiche le prix en crédits et demande confirmation avant de démarrer, suit la tâche et enregistre les résultats à côté du fichier.
npx vocnu login
npx vocnu translate film.mkv --to frOptions
| Option | Fonction |
|---|---|
--output video|audio|subtitles | La vidéo avec voix off (par défaut pour les fichiers vidéo), l’audio de la voix off ou les sous-titres seuls |
--from <lang> | La langue parlée, détectée par défaut |
--voice female|male | Une voix féminine ou masculine |
--format mp4|mkv|mov|webm|avi | Format du fichier vidéo ; celui du fichier importé par défaut, sinon MP4 |
--audio-format m4a|mp3|wav|flac|ogg | Format audio de la voix off |
--burn-subtitles | Sous-titres incrustés dans l’image |
--out <dir> | Dossier de destination des résultats |
--yes | Démarrer sans confirmer le prix |
--no-wait | Démarrer la tâche et renvoyer son identifiant |
Autres commandes
vocnu creditsvocnu languagesvocnu jobsvocnu status <job>vocnu download <job>vocnu cancel <job>vocnu logout
Serveur MCP
Ajoutez Vocnu à Claude ou à tout autre assistant compatible MCP, puis demandez-lui de traduire une vidéo. Il importe le fichier, vous indique le prix, ne démarre qu’avec votre accord, suit la tâche et enregistre les fichiers.
Claude Code
claude mcp add vocnu -e VOCNU_TOKEN=vocnu_... -- npx -y vocnu mcpClaude Desktop et autres clients MCP
{
"mcpServers": {
"vocnu": {
"command": "npx",
"args": ["-y", "vocnu", "mcp"],
"env": { "VOCNU_TOKEN": "vocnu_..." }
}
}
}Demandez ensuite, par exemple : « Traduisez ~/Videos/film.mkv en lituanien avec Vocnu. »
Outils
vocnu_upload_media- Importe un fichier depuis votre ordinateur
vocnu_start_job- Démarre une tâche une fois son prix accepté
vocnu_job_status- Affiche la progression d’une tâche
vocnu_download_results- Enregistre les fichiers terminés
vocnu_languages- Liste les langues cibles
vocnu_credits- Affiche votre solde de crédits
vocnu_list_jobs- Liste vos tâches
vocnu_cancel_job- Annule une tâche
Jetons API
Créez un jeton dans l’application, sous Paramètres, API & MCP. Il ne s’affiche qu’une fois : la ligne de commande l’enregistre lorsque vous exécutez vocnu login, ou vous pouvez le définir dans VOCNU_TOKEN.
Un jeton peut importer des fichiers, afficher les prix, démarrer et suivre des tâches, télécharger leurs résultats et consulter vos crédits. Il ne peut ni payer, ni modifier votre profil, ni gérer les jetons. Révoquez-le à tout moment ; l’application affiche la dernière utilisation de chaque jeton.
Données ouvertes
- Le catalogue des voix : chaque voix avec sa langue, son genre et un extrait, au format JSON.
- Le répertoire des noms : la graphie des personnages, lieux et termes des films et séries dans chaque langue, au format JSON sous CC BY-SA 4.0.
Questions et réponses
Le moteur est-il gratuit ?
Oui. Il est open source sous AGPL-3.0, et vous ne payez OpenAI et ElevenLabs que pour l’utilisation de vos propres clés. Le service hébergé ne nécessite ni clé ni configuration ; il fonctionne avec des crédits.
La ligne de commande et le serveur MCP nécessitent-ils un compte ?
Oui. Ils utilisent le service hébergé avec un jeton API personnel : les crédits, prix et remboursements sont les mêmes que dans l’application, et le prix s’affiche avant toute facturation.
Puis-je utiliser le moteur dans un produit propriétaire ?
L’AGPL-3.0 vous demande de partager vos modifications si vous proposez le moteur comme service réseau. Pour d’autres conditions, écrivez à support@vocnu.com.