Für Entwickler: Open-Source-Engine, CLI und MCP-Server

Open-Source-Engine

Dieselbe Pipeline wie im gehosteten Dienst, unter AGPL-3.0: Spracherkennung, Übersetzung, zeitliche Abstimmung des Voice-overs und Tonmischung. Betreiben Sie sie auf Ihrem eigenen Computer mit Ihren eigenen OpenAI- und ElevenLabs-Schlüsseln.

Was sie kann

Erkennt Sprache mit faster-whisper auf Ihrer GPU oder CPU, unterstützt durch bereits vorhandene Untertitelspuren der Datei.
Übersetzt mit OpenAI: Analyse des gesamten Transkripts, abschnittsweise Übersetzung mit Kontext, unabhängige Prüfung und ein Zeichenlimit pro Zeile, damit jede in die verfügbare Zeit passt.
Liest mit ElevenLabs-Stimmen vor. Zu lange Zeilen werden erneut aufgenommen, kürzer formuliert und erst danach beschleunigt, höchstens auf das 1,08-Fache.
Mischt das Voice-over: Der Originalton wird während jeder Zeile abgesenkt. Videos behalten den Originalton als zweite Tonspur.
Erstellt MP4, MKV, MOV, WebM oder AVI mit zuschaltbaren Untertiteln, Audiodateien in M4A, MP3, WAV, FLAC oder OGG sowie Untertitel in SRT, VTT und ASS.
Verwendet für Namen aus bekannten Filmen und Serien die Schreibweisen der öffentlichen Namensbibliothek.

Was Sie benötigen

uv und ffmpeg. Tesseract ist optional für bildbasierte Untertitel.
Eine NVIDIA-GPU beschleunigt die Spracherkennung um ein Vielfaches; mit der CPU funktioniert sie auch, aber langsam.
Ihre eigenen OpenAI- und ElevenLabs-Schlüssel. Sie bezahlen die Anbieter direkt: bei unseren Durchläufen etwa 0,05 bis 0,10 USD pro Minute Sprache. Ein Beleg zeigt die genauen Beträge.

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

AGPL-3.0: Sie dürfen die Engine nutzen, ändern und weitergeben. Wenn Sie sie als Netzwerkdienst anbieten, geben Sie Ihre Änderungen unter derselben Lizenz weiter. Hinweise von Muttersprachlern zu einer Sprache gehören zu den wertvollsten Beiträgen.

Kommandozeile

Das npm-Paket vocnu für Node.js 20 oder neuer. Es lädt eine Datei mit bis zu 10 GB hoch, zeigt den Preis in Credits und fragt vor dem Start nach Bestätigung, verfolgt den Auftrag und speichert die Ergebnisse neben der Datei.

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

Optionen

Option	Funktion
`--output video\|audio\|subtitles`	Video mit Voice-over (Standard bei Videodateien), Voice-over als Audiodatei oder nur Untertitel
`--from <lang>`	Gesprochene Sprache, standardmäßig automatisch erkannt
`--voice female\|male`	Eine weibliche oder männliche Stimme
`--format mp4\|mkv\|mov\|webm\|avi`	Videoformat; standardmäßig das Format der hochgeladenen Datei, andernfalls MP4
`--audio-format m4a\|mp3\|wav\|flac\|ogg`	Audioformat des Voice-overs
`--burn-subtitles`	Untertitel fest ins Bild einbrennen
`--out <dir>`	Speicherort der Ergebnisse
`--yes`	Ohne Preisbestätigung starten
`--no-wait`	Auftrag starten und seine ID zurückgeben

Weitere Befehle

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

MCP-Server

Fügen Sie Vocnu zu Claude oder einem anderen Assistenten mit MCP-Unterstützung hinzu und bitten Sie ihn, ein Video zu übersetzen. Er lädt die Datei hoch, nennt Ihnen den Preis, startet erst nach Ihrer Zustimmung, verfolgt den Auftrag und speichert die Dateien.

Claude Code

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

Claude Desktop und andere MCP-Clients

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

Fragen Sie dann zum Beispiel: „Übersetzen Sie ~/Videos/film.mkv mit Vocnu ins Litauische.“

Tools

vocnu_upload_media: Lädt eine Datei von Ihrem Computer hoch
vocnu_start_job: Startet einen Auftrag nach Ihrer Zustimmung zum Preis
vocnu_job_status: Zeigt den Fortschritt eines Auftrags
vocnu_download_results: Speichert die fertigen Dateien
vocnu_languages: Listet die Zielsprachen auf
vocnu_credits: Zeigt Ihr Credit-Guthaben
vocnu_list_jobs: Listet Ihre Aufträge auf
vocnu_cancel_job: Bricht einen Auftrag ab

API-Tokens

Erstellen Sie in der App unter Einstellungen, API & MCP ein Token. Es wird nur einmal angezeigt: Die Kommandozeile speichert es, wenn Sie vocnu login ausführen. Alternativ setzen Sie es als VOCNU_TOKEN.

Ein Token kann Dateien hochladen, Preise anzeigen, Aufträge starten und verfolgen, Ergebnisse herunterladen und Ihr Credit-Guthaben lesen. Es kann keine Zahlungen ausführen, Ihr Profil ändern oder Tokens verwalten. Sie können es jederzeit widerrufen; die App zeigt, wann jedes Token zuletzt verwendet wurde.

Token erstellen

Offene Daten

Der Stimmenkatalog: jede Stimme mit Sprache, Geschlecht und Hörprobe, als JSON.
Die Namensbibliothek: Schreibweisen von Figuren, Orten und Begriffen aus Filmen und Serien in jeder Sprache, als JSON unter CC BY-SA 4.0.

Fragen und Antworten

Ist die Engine kostenlos?

Ja. Sie ist Open Source unter AGPL-3.0. Sie bezahlen OpenAI und ElevenLabs nur für die Nutzung über Ihre eigenen Schlüssel. Der gehostete Dienst benötigt weder Schlüssel noch Einrichtung; er wird über Credits abgerechnet.

Benötigen die Kommandozeile und der MCP-Server ein Konto?

Ja. Sie nutzen den gehosteten Dienst mit einem persönlichen API-Token: Es gelten dieselben Credits, Preise und Erstattungen wie in der App. Sie sehen den Preis, bevor etwas berechnet wird.

Kann ich die Engine in einem Closed-Source-Produkt verwenden?

Die AGPL-3.0 verlangt, dass Sie Ihre Änderungen weitergeben, wenn Sie die Engine als Netzwerkdienst anbieten. Für andere Bedingungen schreiben Sie an support@vocnu.com.

Vocnu für Entwickler