Vocnu para desenvolvedores
O motor do Vocnu é de código aberto. A linha de comando e o servidor MCP levam o serviço hospedado ao seu terminal e ao seu assistente de AI com um token pessoal de API.
Motor de código aberto
O mesmo fluxo de processamento do serviço hospedado, sob a AGPL-3.0: reconhecimento de fala, tradução, sincronização da narração e mixagem. Execute no seu computador com suas próprias chaves da OpenAI e da ElevenLabs.
O que ele faz
- Reconhece a fala com faster-whisper na sua GPU ou CPU, com o auxílio das faixas de legendas já presentes no arquivo.
- Traduz com OpenAI: análise de toda a transcrição, tradução em blocos com contexto, revisão independente e um limite de caracteres por linha, para que cada uma caiba no tempo disponível.
- Narra com vozes da ElevenLabs. Falas longas demais são gravadas novamente, reformuladas de modo mais curto e só então aceleradas, no máximo a 1,08 vezes a velocidade original.
- Mixa o voice-over: o volume original diminui durante cada fala, e os vídeos mantêm o áudio original como segunda faixa.
- Gera MP4, MKV, MOV, WebM ou AVI com legendas que podem ser ativadas ou desativadas, áudio M4A, MP3, WAV, FLAC ou OGG e legendas SRT, VTT e ASS.
- Usa a grafia dos nomes de filmes e séries conhecidos conforme a biblioteca de nomes pública.
O que você precisa
- uv e ffmpeg. Tesseract é opcional, para legendas em imagem.
- Uma GPU NVIDIA torna o reconhecimento de fala várias vezes mais rápido; a CPU também funciona, mas lentamente.
- Suas próprias chaves da OpenAI e da ElevenLabs. Você paga diretamente aos provedores: em nossas execuções, cerca de USD 0,05 a 0,10 por minuto de fala, com os valores exatos em um comprovante.
uvx --from git+https://github.com/vocnu/engine \
vocnu-engine translate film.mkv --to ptAGPL-3.0: você pode usar, modificar e compartilhar o motor. Se oferecê-lo como serviço em rede, deve compartilhar suas alterações sob a mesma licença. Observações de falantes nativos sobre um idioma estão entre as contribuições mais valiosas.
Linha de comando
O pacote npm vocnu, para Node.js 20 ou superior. Ele envia um arquivo de até 10 GB, mostra o preço em créditos e pede confirmação antes de começar, acompanha a tarefa e salva os resultados na mesma pasta do arquivo.
npx vocnu login
npx vocnu translate film.mkv --to ptOpções
| Opção | O que faz |
|---|---|
--output video|audio|subtitles | O vídeo com voice-over (padrão para arquivos de vídeo), o áudio do voice-over ou apenas legendas |
--from <lang> | O idioma falado, detectado por padrão |
--voice female|male | Uma voz feminina ou masculina |
--format mp4|mkv|mov|webm|avi | Formato do vídeo; por padrão, o mesmo do arquivo enviado, ou MP4 se não for possível |
--audio-format m4a|mp3|wav|flac|ogg | Formato do áudio do voice-over |
--burn-subtitles | Legendas incorporadas à imagem |
--out <dir> | Onde salvar os resultados |
--yes | Inicia sem confirmar o preço |
--no-wait | Inicia a tarefa e retorna seu ID |
Outros comandos
vocnu creditsvocnu languagesvocnu jobsvocnu status <job>vocnu download <job>vocnu cancel <job>vocnu logout
Servidor MCP
Adicione o Vocnu ao Claude ou a qualquer outro assistente compatível com MCP e peça para traduzir um vídeo. Ele envia o arquivo, informa o preço, só começa com sua confirmação, acompanha a tarefa e salva os arquivos.
Claude Code
claude mcp add vocnu -e VOCNU_TOKEN=vocnu_... -- npx -y vocnu mcpClaude Desktop e outros clientes MCP
{
"mcpServers": {
"vocnu": {
"command": "npx",
"args": ["-y", "vocnu", "mcp"],
"env": { "VOCNU_TOKEN": "vocnu_..." }
}
}
}Depois peça, por exemplo: “Traduza ~/Videos/film.mkv para lituano com o Vocnu.”
Ferramentas
vocnu_upload_media- Envia um arquivo do seu computador
vocnu_start_job- Inicia uma tarefa após você aceitar o preço
vocnu_job_status- Mostra o progresso de uma tarefa
vocnu_download_results- Salva os arquivos concluídos
vocnu_languages- Lista os idiomas de destino
vocnu_credits- Mostra seu saldo de créditos
vocnu_list_jobs- Lista suas tarefas
vocnu_cancel_job- Cancela uma tarefa
Tokens de API
Crie um token no app em Configurações, API & MCP. Ele é exibido uma única vez: a linha de comando o salva quando você executa vocnu login, ou você pode defini-lo como VOCNU_TOKEN.
Um token pode enviar arquivos, mostrar preços, iniciar e acompanhar tarefas, baixar seus resultados e consultar seus créditos. Ele não pode fazer pagamentos, alterar seu perfil nem gerenciar tokens. Revogue-o quando quiser; o app mostra quando cada token foi usado pela última vez.
Dados abertos
- O catálogo de vozes: cada voz com seu idioma, gênero e uma amostra, em JSON.
- A biblioteca de nomes: como os personagens, lugares e termos de filmes e séries são escritos em cada idioma, em JSON sob CC BY-SA 4.0.
Perguntas e respostas
O motor é gratuito?
Sim. Ele é de código aberto sob a AGPL-3.0, e você paga à OpenAI e à ElevenLabs apenas pelo uso das suas próprias chaves. O serviço hospedado não precisa de chaves nem de configuração; ele funciona com créditos.
A linha de comando e o servidor MCP precisam de uma conta?
Sim. Eles usam o serviço hospedado com um token pessoal de API: os mesmos créditos, preços e reembolsos do app, e você vê o preço antes de qualquer cobrança.
Posso usar o motor em um produto de código fechado?
A AGPL-3.0 exige que você compartilhe suas alterações ao oferecer o motor como serviço em rede. Para outras condições, escreva para support@vocnu.com.