Sviluppatori: motore open source, CLI e server MCP

Motore open source

La stessa pipeline del servizio ospitato, con licenza AGPL-3.0: riconoscimento vocale, traduzione, sincronizzazione della narrazione e mixaggio. Eseguila sul tuo computer con le tue chiavi OpenAI ed ElevenLabs.

Cosa fa

Riconosce il parlato con faster-whisper sulla tua GPU o CPU, con l'aiuto delle tracce di sottotitoli già presenti nel file.
Traduce con OpenAI: analisi dell'intera trascrizione, traduzione a blocchi con contesto, revisione indipendente e un limite di caratteri per ogni riga, così da rispettare il tempo disponibile.
Legge il testo con le voci ElevenLabs. Le battute troppo lunghe vengono registrate di nuovo, riformulate in modo più breve e solo alla fine accelerate, fino a un massimo di 1,08 volte.
Mixa il voice-over: l'audio originale si abbassa durante ogni battuta e viene conservato nei video come seconda traccia.
Genera video MP4, MKV, MOV, WebM o AVI con sottotitoli attivabili, audio M4A, MP3, WAV, FLAC o OGG e sottotitoli SRT, VTT e ASS.
Scrive i nomi di film e serie noti secondo l'archivio pubblico dei nomi.

Cosa ti serve

uv e ffmpeg. Tesseract è facoltativo, per i sottotitoli in formato immagine.
Una GPU NVIDIA rende il riconoscimento vocale molto più veloce; funziona anche con la CPU, ma lentamente.
Le tue chiavi OpenAI ed ElevenLabs. Paghi direttamente i fornitori: nelle nostre esecuzioni, circa 0,05–0,10 USD al minuto di parlato. Una ricevuta mostra gli importi esatti.

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

AGPL-3.0: puoi usare, modificare e condividere il motore. Se lo offri come servizio di rete, devi condividere le tue modifiche con la stessa licenza. Le osservazioni linguistiche dei madrelingua sono tra i contributi più preziosi.

Riga di comando

Il pacchetto npm vocnu, per Node.js 20 o versioni successive. Carica un file fino a 10 GB, mostra il prezzo in crediti e chiede conferma prima di iniziare, segue l'elaborazione e salva i risultati accanto al file.

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

Opzioni

Opzione	Cosa fa
`--output video\|audio\|subtitles`	Il video con voice-over (predefinito per i file video), l'audio del voice-over o solo i sottotitoli
`--from <lang>`	La lingua parlata, rilevata automaticamente per impostazione predefinita
`--voice female\|male`	Una voce femminile o maschile
`--format mp4\|mkv\|mov\|webm\|avi`	Formato del file video; per impostazione predefinita quello del file caricato, altrimenti MP4
`--audio-format m4a\|mp3\|wav\|flac\|ogg`	Formato audio del voice-over
`--burn-subtitles`	Sottotitoli impressi nell'immagine
`--out <dir>`	Dove salvare i risultati
`--yes`	Avvia senza confermare il prezzo
`--no-wait`	Avvia l'elaborazione e restituisce il suo ID

Altri comandi

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

Server MCP

Aggiungi Vocnu a Claude o a qualsiasi altro assistente che supporti MCP, poi chiedigli di tradurre un video. Carica il file, ti comunica il prezzo, avvia solo dopo la tua conferma, segue l'elaborazione e salva i file.

Claude Code

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

Claude Desktop e altri client MCP

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

Poi chiedi, per esempio: «Traduci ~/Videos/film.mkv in lituano con Vocnu».

Strumenti

vocnu_upload_media: Carica un file dal tuo computer
vocnu_start_job: Avvia un'elaborazione dopo che hai accettato il prezzo
vocnu_job_status: Mostra l'avanzamento di un'elaborazione
vocnu_download_results: Salva i file completati
vocnu_languages: Elenca le lingue di destinazione
vocnu_credits: Mostra il tuo saldo crediti
vocnu_list_jobs: Elenca le tue elaborazioni
vocnu_cancel_job: Annulla un'elaborazione

Token API

Crea un token nell'app in Impostazioni, API e MCP. Viene mostrato una sola volta: la riga di comando lo salva quando esegui vocnu login, oppure puoi impostarlo come VOCNU_TOKEN.

Un token può caricare file, mostrare prezzi, avviare e seguire elaborazioni, scaricarne i risultati e leggere il tuo saldo crediti. Non può effettuare pagamenti, modificare il tuo profilo o gestire token. Puoi revocarlo in qualsiasi momento; l'app mostra l'ultimo utilizzo di ogni token.

Crea un token

Dati aperti

Il catalogo delle voci: ogni voce con lingua, genere e un esempio, in formato JSON.
L'archivio dei nomi: come si scrivono personaggi, luoghi e termini di film e serie in ogni lingua, in formato JSON con licenza CC BY-SA 4.0.

Domande e risposte

Il motore è gratuito?

Sì. È open source con licenza AGPL-3.0 e paghi OpenAI ed ElevenLabs solo per l'uso delle tue chiavi. Il servizio ospitato non richiede chiavi né configurazione: funziona a crediti.

La riga di comando e il server MCP richiedono un account?

Sì. Usano il servizio ospitato con un token API personale: stessi crediti, prezzi e rimborsi dell'app. Vedi il prezzo prima di qualsiasi addebito.

Posso usare il motore in un prodotto a codice chiuso?

La licenza AGPL-3.0 richiede di condividere le tue modifiche quando offri il motore come servizio di rete. Per condizioni diverse, scrivi a support@vocnu.com.

Vocnu per sviluppatori