Vocnu для розробників
Рушій Vocnu має відкритий код. Командний рядок і MCP-сервер дають доступ до хмарного сервісу з термінала й AI-асистента через особистий API-токен.
Рушій із відкритим кодом
Той самий конвеєр обробки, що працює в хмарному сервісі, під ліцензією AGPL-3.0: розпізнавання мовлення, переклад, синхронізація озвучення та зведення звуку. Запускайте його на власному комп’ютері зі своїми ключами OpenAI та ElevenLabs.
Що він робить
- Розпізнає мовлення через faster-whisper на графічному або центральному процесорі, використовуючи наявні у файлі доріжки субтитрів як допоміжне джерело.
- Перекладає через OpenAI: аналізує всю розшифровку, перекладає частинами з урахуванням контексту, виконує незалежну перевірку й задає ліміт символів для кожного рядка, щоб він уклався у відведений час.
- Озвучує голосами ElevenLabs. Задовгі репліки записує повторно, перефразовує коротше й лише потім прискорює — щонайбільше в 1,08 раза.
- Зводить закадрове озвучення: приглушує оригінальний звук під час кожної репліки та зберігає його у відео як другу аудіодоріжку.
- Зберігає відео MP4, MKV, MOV, WebM або AVI із субтитрами, які можна вмикати й вимикати, аудіо M4A, MP3, WAV, FLAC або OGG та субтитри SRT, VTT і ASS.
- Використовує написання імен і назв із відомих фільмів та серіалів за відкритою бібліотекою імен і назв.
Що потрібно
- uv і ffmpeg. Для графічних субтитрів можна додатково встановити Tesseract.
- Графічний процесор NVIDIA прискорює розпізнавання мовлення в рази; центральний процесор теж підходить, але працює повільно.
- Власні ключі OpenAI та ElevenLabs. Ви платите постачальникам напряму: у наших запусках це приблизно 0,05–0,10 долара США за хвилину мовлення, а точні суми вказані у квитанції.
uvx --from git+https://github.com/vocnu/engine \
vocnu-engine translate film.mkv --to ukAGPL-3.0: ви можете використовувати, змінювати й поширювати рушій. Якщо ви надаєте його як мережевий сервіс, потрібно оприлюднити свої зміни під тією самою ліцензією. Зауваження щодо мови від її носіїв — один із найцінніших внесків.
Командний рядок
Пакет npm vocnu для Node.js 20 або новішої версії. Завантажує файл розміром до 10 ГБ, показує ціну в кредитах і запитує підтвердження перед початком, стежить за завданням та зберігає результати поруч із файлом.
npx vocnu login
npx vocnu translate film.mkv --to ukПараметри
| Параметр | Що робить |
|---|---|
--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 creditsvocnu languagesvocnu jobsvocnu 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 mcpClaude 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.