للمطورين: محرك مفتوح المصدر وCLI وخادم MCP

محرك مفتوح المصدر

مسار المعالجة نفسه الذي تستخدمه الخدمة المستضافة، بترخيص 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 ar

AGPL-3.0: يمكنك استخدام المحرك وتعديله ومشاركته، وإذا قدمته كخدمة عبر الشبكة، فعليك مشاركة تعديلاتك بالترخيص نفسه. ملاحظات الناطقين الأصليين حول لغاتهم من أكثر المساهمات قيمة.

سطر الأوامر

حزمة npm باسم vocnu، لإصدار Node.js 20 أو أحدث. ترفع ملفًا يصل حجمه إلى 10 غيغابايت، وتعرض السعر بالأرصدة وتطلب موافقتك قبل البدء، ثم تتابع المهمة وتحفظ النتائج بجانب الملف.

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

الخيارات

الخيار	وظيفته
`--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`	بدء المهمة وإرجاع معرّفها

أوامر أخرى

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 للمطورين