Разработчикам: движок с открытым кодом, CLI и MCP-сервер

Движок с открытым кодом

Тот же процесс обработки, что и в облачном сервисе, под лицензией AGPL-3.0: распознавание речи, перевод, синхронизация озвучки и сведение звука. Запускайте на своём компьютере со своими ключами OpenAI и ElevenLabs.

Что он делает

Распознаёт речь с помощью faster-whisper на GPU или CPU, используя для поддержки уже имеющиеся в файле дорожки субтитров.
Переводит с помощью OpenAI: анализирует всю расшифровку, переводит фрагментами с учётом контекста, проводит независимую проверку и ограничивает число символов в каждой реплике, чтобы она укладывалась в отведённое время.
Озвучивает голосами ElevenLabs. Слишком длинные реплики записываются заново, затем сокращаются и лишь после этого ускоряются — не более чем в 1,08 раза.
Сводит закадровую озвучку: оригинальный звук приглушается на время каждой реплики и сохраняется в видео отдельной второй дорожкой.
Создаёт видео MP4, MKV, MOV, WebM или AVI с отключаемыми субтитрами, аудио M4A, MP3, WAV, FLAC или OGG и субтитры SRT, VTT и ASS.
Использует написание имён из известных фильмов и сериалов по общедоступной библиотеке имён.

Что понадобится

uv и ffmpeg. Для графических субтитров можно дополнительно установить Tesseract.
Видеокарта NVIDIA многократно ускоряет распознавание речи; на CPU оно тоже работает, но медленно.
Собственные ключи OpenAI и ElevenLabs. Вы платите напрямую провайдерам: в наших запусках это около 0,05–0,10 доллара США за минуту речи. Точные суммы указаны в отчёте о расходах.

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

AGPL-3.0: вы можете использовать, изменять и распространять движок. Если вы предоставляете его как сетевой сервис, ваши изменения нужно публиковать под той же лицензией. Замечания носителей языка — один из самых ценных видов помощи проекту.

Командная строка

Пакет npm vocnu для Node.js 20 и новее. Загружает файл размером до 10 ГБ, показывает цену в кредитах и запрашивает подтверждение перед запуском, отслеживает задачу и сохраняет результаты рядом с исходным файлом.

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

Параметры

Параметр	Назначение
`--output video\|audio\|subtitles`	Видео с закадровой озвучкой (по умолчанию для видеофайлов), аудио закадровой озвучки или только субтитры
`--from <lang>`	Язык речи; по умолчанию определяется автоматически
`--voice female\|male`	Женский или мужской голос
`--format mp4\|mkv\|mov\|webm\|avi`	Формат видеофайла; по умолчанию — как у загруженного файла, иначе MP4
`--audio-format m4a\|mp3\|wav\|flac\|ogg`	Аудиоформат закадровой озвучки
`--burn-subtitles`	Встроить субтитры в изображение
`--out <dir>`	Папка для результатов
`--yes`	Начать без подтверждения цены
`--no-wait`	Запустить задачу и вернуть её ID

Другие команды

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

MCP-сервер

Добавьте Vocnu в Claude или другой ассистент с поддержкой MCP и попросите перевести видео. Ассистент загрузит файл, сообщит цену, запустит обработку только с вашего согласия, отследит задачу и сохранит файлы.

Claude Code

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

Claude Desktop и другие MCP-клиенты

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

Затем попросите, например: «Переведи ~/Videos/film.mkv на литовский с помощью Vocnu».

Инструменты

vocnu_upload_media: Загружает файл с вашего компьютера
vocnu_start_job: Запускает задачу после подтверждения цены
vocnu_job_status: Показывает ход выполнения задачи
vocnu_download_results: Сохраняет готовые файлы
vocnu_languages: Показывает языки перевода
vocnu_credits: Показывает баланс кредитов
vocnu_list_jobs: Показывает ваши задачи
vocnu_cancel_job: Отменяет задачу

API-токены

Создайте токен в приложении: «Настройки» → «API и MCP». Он показывается только один раз. Командная строка сохранит его при запуске vocnu login, либо вы можете задать его в VOCNU_TOKEN.

Токен позволяет загружать файлы, узнавать цены, запускать и отслеживать задачи, скачивать результаты и проверять баланс кредитов. Он не позволяет оплачивать услуги, менять профиль или управлять токенами. Токен можно отозвать в любое время; в приложении видно, когда каждый токен использовался последний раз.

Создать токен

Открытые данные

Каталог голосов: язык, пол и образец каждого голоса в формате JSON.
Библиотека имён: написание имён персонажей, названий мест и терминов из фильмов и сериалов на каждом языке, в формате JSON под лицензией CC BY-SA 4.0.

Вопросы и ответы

Движок бесплатный?

Да. Его исходный код открыт под лицензией AGPL-3.0, а OpenAI и ElevenLabs вы платите только за использование своих ключей. Для облачного сервиса не нужны ключи или настройка — он работает за кредиты.

Нужен ли аккаунт для командной строки и MCP-сервера?

Да. Они обращаются к облачному сервису с личным API-токеном: кредиты, цены и правила возврата те же, что и в приложении. Цена известна до списания кредитов.

Можно ли использовать движок в закрытом продукте?

AGPL-3.0 требует публиковать ваши изменения, если вы предоставляете движок как сетевой сервис. Чтобы обсудить другие условия, напишите на support@vocnu.com.

Vocnu для разработчиков