개발자를 위한 Vocnu

오픈 소스 엔진

호스팅 서비스와 동일한 파이프라인을 AGPL-3.0으로 제공해요. 음성 인식, 번역, 내레이션 타이밍 조정, 믹싱을 처리해요. 자신의 OpenAI 및 ElevenLabs 키로 컴퓨터에서 직접 실행하세요.

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

AGPL-3.0에 따라 엔진을 사용, 수정, 공유할 수 있어요. 네트워크 서비스로 제공하는 경우 수정 사항도 같은 라이선스로 공개해야 해요. 원어민이 전해 주는 언어 관련 의견은 특히 소중한 기여예요.

명령줄

Node.js 20 이상에서 사용하는 npm 패키지 vocnu예요. 최대 10 GB 파일을 업로드하고 크레딧 요금을 표시한 뒤 시작 전에 확인을 요청해요. 작업 진행 상황을 확인하고 원본 파일과 같은 폴더에 결과를 저장해요.

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

옵션

기타 명령어

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

MCP 서버

Claude나 MCP를 지원하는 다른 어시스턴트에 Vocnu를 추가한 뒤 영상 번역을 요청하세요. 파일을 업로드하고 요금을 안내하며, 동의한 경우에만 시작해요. 이후 작업 진행 상황을 확인하고 파일을 저장해요.

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_..." }
    }
  }
}

그런 다음 이렇게 요청해 보세요. “Vocnu로 ~/Videos/film.mkv 파일을 리투아니아어로 번역해 줘.”

도구

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으로 제공해요.
• 이름 라이브러리: 영화와 시리즈의 등장인물, 장소, 용어를 언어별로 어떻게 표기하는지 CC BY-SA 4.0에 따라 JSON으로 제공해요.

자주 묻는 질문