اقرأ هذا الدليل أيضاً بـ English أو Français.
يستطيع Claude Code كتابة كود الفيديو، ترتيب مشاهد Remotion، وتشغيل أوامر FFmpeg، لكنه لا يولد وحده صوتاً جزائرياً طبيعياً. لهذا أضفنا إلى Natiq خادم MCP بعيداً وإضافة مفتوحة المصدر لـ Claude Code. بعد الربط، يستطيع Claude اختيار صوت جزائري، إرسال نص كل مشهد، انتظار اكتمال التوليد، ثم تنزيل ملف الصوت داخل مشروع الفيديو.
الهدف ليس إضافة صوت واحد في نهاية العمل فقط. Claude يصبح قادراً على بناء الفيديو حول الصوت الحقيقي: يقسم النص إلى مشاهد، يولد مقطعاً لكل مشهد، ويستخدم duration_seconds التي يعيدها Natiq لضبط مدة المشهد بدقة.
ما الذي يضيفه Natiq إلى Claude Code؟
الإضافة تربط Claude بالأدوات التالية:
- عرض الأصوات الجزائرية المتاحة وأساليب الأداء.
- التحقق من رصيد الحساب قبل بدء مشروع كبير.
- توليد الصوت لكل مشهد بشكل غير متزامن.
- متابعة حالة التوليد بدون إعادة إرسال النص ودفع الرصيد مرتين.
- استرجاع رابط تنزيل مؤقت وآمن ومدة الصوت الحقيقية.
خادم MCP يعمل على https://natiq.studio/mcp ويستخدم نفس مفاتيح API، حدود الاستعمال، الصلاحيات، وتسعير الرصيد الموجودة في واجهة Natiq البرمجية.
أسهل طريقة للربط
افتح دليل ربط Claude Code واضغط على Copy setup prompt. ألصق النص في Claude Code، وسيثبت Claude الإضافة المفتوحة المصدر ويتأكد من ظهور خادم natiq.
إذا أردت التثبيت يدوياً، استعمل هذا الأمر داخل Claude Code:
/plugin install natiq-voiceover --marketplace Natiq-studio/natiq-voiceover
أنشئ مفتاحاً بصلاحية write من صفحة مفاتيح API، ثم أدخله مرة واحدة في خانة Natiq API key داخل إعدادات الإضافة. يخزن Claude القيمة في مخزن بيانات الاعتماد الآمن على جهازك.
سير عمل عملي لفيديو من عدة مشاهد
بعد الربط، يمكنك أن تطلب من Claude:
اصنع فيديو منتج من ثلاثة مشاهد بـ Remotion. اكتب التعليق بالدارجة الجزائرية، استعمل نفس الصوت في كل المشاهد، احفظ الملفات في public/audio، واضبط مدة كل مشهد حسب مدة الصوت الحقيقية. لا تعاود توليد النص إذا لم يتغير.
سيتبع Claude عادة هذا الترتيب:
- يفحص الرصيد والأصوات المتاحة.
- يقسم الرسالة إلى نص قصير وواضح لكل مشهد.
- يرسل كل نص مرة واحدة ويحفظ رقم المهمة
speech_.... - يتابع المهمة حتى تصبح
successبدلاً من إنشاء مهمة مدفوعة جديدة. - ينزل ملفات WAV إلى المشروع.
- يضبط عدد إطارات كل مشهد من مدة الملف الحقيقية.
ضبط مدة مشاهد Remotion
إذا كان الفيديو يعمل على 30 إطاراً في الثانية، يمكن حساب مدة المشهد بهذه الطريقة:
const fps = 30;
const durationInFrames = Math.ceil(duration_seconds * fps) + 6;
الستة إطارات الإضافية تعطي وقفة قصيرة بين المشاهد. استعمل القيمة التي يعيدها Natiq بعد نجاح المهمة، ولا تحاول تقدير المدة من عدد الكلمات؛ سرعة النطق والوقفات تختلف من نص إلى آخر.
تنزيل الصوت بأمان
خادم MCP لا يستطيع الكتابة مباشرة في حاسوب المستخدم. لذلك يعيد رابطاً مؤقتاً يستطيع Claude تنزيله إلى المشروع:
curl --fail --location --output public/audio/scene-01.wav "RETURNED_AUDIO_URL"
الرابط موقع ومؤقت ولا يحتاج إلى إرسال مفتاح API معه. لا تحفظ الرابط في Git، لأن المشروع يحتاج إلى الملف المحلي بعد التنزيل وليس إلى رابط التخزين المؤقت.
ماذا عن توقيت الترجمة المكتوبة؟
يعيد Natiq مدة المقطع كاملة، لكنه لا يقدم توقيت كل كلمة. يستطيع Claude توزيع الجمل على مدة المشهد أو إنشاء توقيت تقريبي للكلمات، ويجب اعتباره تقديراً فقط. إذا كنت تحتاج إلى karaoke highlighting متزامن بدقة، أضف مرحلة محاذاة صوتية منفصلة بعد توليد الملف.
أفضل ممارسات توفر الوقت والرصيد
- راجع نصوص المشاهد قبل بدء التوليد.
- استعمل صوتاً واحداً للمحافظة على هوية الفيديو.
- احتفظ برقم المهمة وإعدادات كل مشهد في ملف المشروع.
- أعد استعمال الملف إذا لم يتغير النص أو الصوت أو أسلوب الأداء.
- افحص الرصيد قبل الحملات الكبيرة.
- انتظر المهمة المعلقة؛ لا تعاود إرسال نفس النص لمجرد أن الصوت لم يجهز فوراً.
يمكنك قراءة دليل إنتاج فيديو منتج بصوت جزائري للحصول على نصائح إضافية حول كتابة المشاهد والإيقاع. وعندما تكون جاهزاً، افتح صفحة ربط Claude Code ودع Claude يثبت Natiq لك.