Vocnu cho nhà phát triển
Dòng lệnh và máy chủ MCP đưa Vocnu vào terminal và trợ lý AI của bạn bằng token API cá nhân.
Dòng lệnh
Gói npm vocnu, dành cho Node.js 20 trở lên. Công cụ tải lên tệp tối đa 10 GB, hiển thị giá bằng tín dụng và hỏi trước khi bắt đầu, theo dõi tác vụ rồi lưu kết quả cạnh tệp gốc.
npx vocnu login
npx vocnu translate film.mkv --to viTùy chọn
| Tùy chọn | Chức năng |
|---|---|
--output video|audio|subtitles | Video có thuyết minh (mặc định cho tệp video), âm thanh thuyết minh hoặc chỉ phụ đề |
--from <lang> | Ngôn ngữ lời nói, mặc định tự nhận diện |
--voice male|female | Giọng nam (mặc định) hoặc giọng nữ |
--format mp4|mkv|mov|webm|avi | Định dạng tệp video; mặc định giữ định dạng tệp tải lên, nếu không thì dùng MP4 |
--audio-format m4a|mp3|wav|flac|ogg | Định dạng âm thanh thuyết minh |
--burn-subtitles | Phụ đề gắn cứng vào hình ảnh |
--original-off | Tắt âm thanh gốc: chỉ có thuyết minh, im lặng giữa các câu |
--out <dir> | Nơi lưu kết quả |
--yes | Bắt đầu mà không xác nhận giá |
--no-wait | Bắt đầu tác vụ và trả về ID |
Các lệnh khác
vocnu creditsvocnu languagesvocnu jobsvocnu status <job>vocnu download <job>vocnu cancel <job>vocnu logout
Máy chủ MCP
Thêm Vocnu vào Claude hoặc trợ lý khác hỗ trợ MCP, rồi yêu cầu dịch video. Công cụ tải tệp lên, báo giá, chỉ bắt đầu khi bạn đồng ý, theo dõi tác vụ và lưu các tệp.
Claude Code
claude mcp add vocnu -e VOCNU_TOKEN=vocnu_... -- npx -y vocnu mcpClaude Desktop và các ứng dụng khách MCP khác
{
"mcpServers": {
"vocnu": {
"command": "npx",
"args": ["-y", "vocnu", "mcp"],
"env": { "VOCNU_TOKEN": "vocnu_..." }
}
}
}Sau đó yêu cầu, ví dụ: “Dịch ~/Videos/film.mkv sang tiếng Litva bằng Vocnu.”
Công cụ
vocnu_upload_media- Tải tệp từ máy tính của bạn lên
vocnu_start_job- Bắt đầu tác vụ khi bạn đồng ý với giá
vocnu_job_status- Hiển thị tiến độ tác vụ
vocnu_download_results- Lưu các tệp thành phẩm
vocnu_languages- Liệt kê các ngôn ngữ đích
vocnu_credits- Hiển thị số dư tín dụng
vocnu_list_jobs- Liệt kê tác vụ của bạn
vocnu_cancel_job- Hủy tác vụ
Token API
Tạo token trong ứng dụng tại Cài đặt, API & MCP. Token chỉ hiển thị một lần: dòng lệnh lưu token khi bạn chạy vocnu login, hoặc bạn đặt token thành VOCNU_TOKEN.
Token có thể tải tệp lên, hiển thị giá, bắt đầu, theo dõi và tải kết quả tác vụ, cũng như đọc số dư tín dụng. Token không thể thanh toán, thay đổi hồ sơ hay quản lý token. Thu hồi bất cứ lúc nào; ứng dụng hiển thị lần sử dụng gần nhất của từng token.
Dữ liệu mở
- Danh mục giọng đọc: mọi giọng cùng ngôn ngữ, giới tính và mẫu nghe, dưới dạng JSON.
- Thư viện tên: cách viết nhân vật, địa danh và thuật ngữ của phim và phim bộ ở từng ngôn ngữ, dưới dạng JSON theo CC BY-SA 4.0.
Hỏi đáp
Dòng lệnh và máy chủ MCP có cần tài khoản không?
Có. Chúng dùng token API cá nhân từ tài khoản Vocnu của bạn: cùng tín dụng, giá và chính sách hoàn tiền như ứng dụng, và bạn thấy giá trước khi bị trừ tín dụng.