Ontwikkelaars: commandoregel, MCP-server en API-tokens

Commandoregel

Het npm-pakket vocnu, voor Node.js 20 of nieuwer. Het uploadt een bestand tot 10 GB, toont de prijs in credits en vraagt om bevestiging voordat het begint, volgt de taak en slaat de resultaten naast het bestand op.

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

Opties

Optie	Wat deze doet
`--output video\|audio\|subtitles`	De video met voice-over (standaard voor videobestanden), de voice-overaudio of alleen ondertitels
`--from <lang>`	De gesproken taal, standaard automatisch herkend
`--voice male\|female`	Een mannelijke stem (standaard) of een vrouwelijke
`--format mp4\|mkv\|mov\|webm\|avi`	Videoformaat; standaard dat van de upload, anders MP4
`--audio-format m4a\|mp3\|wav\|flac\|ogg`	Formaat van de voice-overaudio
`--burn-subtitles`	Ondertitels ingebrand in het beeld
`--original-off`	Het oorspronkelijke geluid uitgeschakeld: alleen de voice-over, met stilte tussen de zinnen
`--out <dir>`	Waar de resultaten worden opgeslagen
`--yes`	Starten zonder de prijs te bevestigen
`--no-wait`	De taak starten en de ID teruggeven

Andere opdrachten

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

MCP-server

Voeg Vocnu toe aan Claude of een andere assistent die MCP ondersteunt en vraag om een video te vertalen. De assistent uploadt het bestand, vertelt je de prijs, begint pas na je akkoord, volgt de taak en slaat de bestanden op.

Claude Code

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

Claude Desktop en andere MCP-clients

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

Vraag daarna bijvoorbeeld: ‘Vertaal ~/Videos/film.mkv naar het Litouws met Vocnu.’

Tools

vocnu_upload_media: Uploadt een bestand vanaf je computer
vocnu_start_job: Start een taak zodra je akkoord gaat met de prijs
vocnu_job_status: Toont de voortgang van een taak
vocnu_download_results: Slaat de voltooide bestanden op
vocnu_languages: Toont de doeltalen
vocnu_credits: Toont je creditsaldo
vocnu_list_jobs: Toont je taken
vocnu_cancel_job: Annuleert een taak

API-tokens

Maak in de app een token aan onder Instellingen, API & MCP. Het wordt één keer getoond: de commandoregel slaat het op wanneer je vocnu login uitvoert, of je stelt het in als VOCNU_TOKEN.

Een token kan bestanden uploaden, prijzen tonen, taken starten, volgen en downloaden en je credits lezen. Het kan niet betalen, je profiel wijzigen of tokens beheren. Je kunt het altijd intrekken; de app toont wanneer elk token voor het laatst is gebruikt.

Token aanmaken

Open data

De stemmencatalogus: elke stem met taal, geslacht en een fragment, als JSON.
De namenbibliotheek: hoe personages, plaatsen en termen uit films en series in elke taal worden geschreven, als JSON onder CC BY-SA 4.0.

Vragen en antwoorden

Hebben de commandoregel en MCP-server een account nodig?

Ja. Ze werken met een persoonlijk API-token uit je Vocnu-account: dezelfde credits, prijzen en terugbetalingen als in de app. Je ziet de prijs voordat er iets wordt afgeschreven.

Vocnu voor ontwikkelaars