Desarrolladores: motor de código abierto, CLI y servidor MCP

Motor de código abierto

El mismo flujo de procesamiento del servicio alojado, bajo AGPL-3.0: reconocimiento de voz, traducción, sincronización de la narración y mezcla. Ejecútalo en tu computadora con tus propias claves de OpenAI y ElevenLabs.

Qué hace

Reconoce el habla con faster-whisper en tu GPU o CPU, con ayuda de las pistas de subtítulos que ya contiene el archivo.
Traduce con OpenAI: un análisis de toda la transcripción, traducción por fragmentos con contexto, una revisión independiente y un límite de caracteres por línea para que cada una se ajuste al tiempo disponible.
Narra con voces de ElevenLabs. Las frases demasiado largas se vuelven a grabar, se reformulan para acortarlas y solo entonces se aceleran, hasta un máximo de 1,08 veces.
Mezcla la voz en off: el sonido original baja durante cada frase y los videos conservan el audio original como segunda pista.
Genera MP4, MKV, MOV, WebM o AVI con subtítulos que puedes activar o desactivar; audio M4A, MP3, WAV, FLAC u OGG; y subtítulos SRT, VTT y ASS.
Escribe los nombres de películas y series conocidas como aparecen en la biblioteca de nombres pública.

Qué necesitas

uv y ffmpeg. Tesseract es opcional, para subtítulos en imágenes.
Una GPU NVIDIA acelera varias veces el reconocimiento de voz; la CPU también sirve, aunque es más lenta.
Tus propias claves de OpenAI y ElevenLabs. Pagas directamente a los proveedores: en nuestras pruebas, entre 0,05 y 0,10 USD por minuto de habla, aproximadamente. Un recibo muestra los importes exactos.

uvx --from git+https://github.com/vocnu/engine \
  vocnu-engine translate film.mkv --to es

AGPL-3.0: puedes usar, modificar y compartir el motor, y si lo ofreces como servicio en red, debes compartir tus cambios bajo la misma licencia. Las observaciones de hablantes nativos sobre un idioma son de las contribuciones más valiosas.

Línea de comandos

El paquete npm vocnu, para Node.js 20 o posterior. Sube un archivo de hasta 10 GB, muestra el precio en créditos y pide confirmación antes de empezar, sigue el trabajo y guarda los resultados junto al archivo.

npx vocnu login
npx vocnu translate film.mkv --to es

Opciones

Opción	Qué hace
`--output video\|audio\|subtitles`	El video con voz en off (predeterminado para archivos de video), el audio de la voz en off o solo los subtítulos
`--from <lang>`	El idioma hablado, detectado de forma predeterminada
`--voice female\|male`	Una voz femenina o masculina
`--format mp4\|mkv\|mov\|webm\|avi`	Formato de video; de forma predeterminada, el del archivo subido o, en su defecto, MP4
`--audio-format m4a\|mp3\|wav\|flac\|ogg`	Formato del audio de la voz en off
`--burn-subtitles`	Subtítulos incrustados en la imagen
`--out <dir>`	Dónde se guardan los resultados
`--yes`	Empezar sin confirmar el precio
`--no-wait`	Iniciar el trabajo y devolver su ID

Otros comandos

vocnu credits
vocnu languages
vocnu jobs
vocnu status <job>
vocnu download <job>
vocnu cancel <job>
vocnu logout

Servidor MCP

Añade Vocnu a Claude o a cualquier otro asistente compatible con MCP y pídele que traduzca un video. Sube el archivo, te indica el precio, empieza solo cuando aceptas, sigue el trabajo y guarda los archivos.

Claude Code

claude mcp add vocnu -e VOCNU_TOKEN=vocnu_... -- npx -y vocnu mcp

Claude Desktop y otros clientes MCP

{
  "mcpServers": {
    "vocnu": {
      "command": "npx",
      "args": ["-y", "vocnu", "mcp"],
      "env": { "VOCNU_TOKEN": "vocnu_..." }
    }
  }
}

Luego pide, por ejemplo: «Traduce ~/Videos/film.mkv al lituano con Vocnu».

Herramientas

vocnu_upload_media: Sube un archivo desde tu computadora
vocnu_start_job: Inicia un trabajo cuando aceptas su precio
vocnu_job_status: Muestra el avance de un trabajo
vocnu_download_results: Guarda los archivos terminados
vocnu_languages: Enumera los idiomas de destino
vocnu_credits: Muestra tu saldo de créditos
vocnu_list_jobs: Enumera tus trabajos
vocnu_cancel_job: Cancela un trabajo

Tokens de API

Crea un token en la aplicación, en Configuración, API y MCP. Solo se muestra una vez: la línea de comandos lo guarda al ejecutar vocnu login, o puedes configurarlo como VOCNU_TOKEN.

Un token permite subir archivos, consultar precios, iniciar y seguir trabajos, descargar sus resultados y consultar tus créditos. No permite pagar, cambiar tu perfil ni gestionar tokens. Puedes revocarlo cuando quieras; la aplicación muestra cuándo se usó cada token por última vez.

Crear un token

Datos abiertos

El catálogo de voces: cada voz con su idioma, género y una muestra, en JSON.
La biblioteca de nombres: cómo se escriben los personajes, lugares y términos de películas y series en cada idioma, en JSON bajo CC BY-SA 4.0.

Preguntas y respuestas

¿El motor es gratuito?

Sí. Es de código abierto bajo AGPL-3.0 y solo pagas a OpenAI y ElevenLabs por el uso de tus propias claves. El servicio alojado no necesita claves ni configuración; funciona con créditos.

¿La línea de comandos y el servidor MCP necesitan una cuenta?

Sí. Usan el servicio alojado con un token de API personal: los mismos créditos, precios y reembolsos que la aplicación, y ves el precio antes de que se cobre nada.

¿Puedo usar el motor en un producto de código cerrado?

La AGPL-3.0 exige compartir tus cambios cuando ofreces el motor como servicio en red. Para otras condiciones, escribe a support@vocnu.com.

Vocnu para desarrolladores