الدبلجة

تدبلج dub_media تسجيلًا واحدًا إلى لغة أخرى بأصوات متحدثيه أنفسهم. على Morphic Dub (mdl_h2z5a7af7y50) تستقبل فيديو بطول حتى 10 دقائق وتعيد الفيديو نفسه بالطول نفسه، مع إعادة نطق كل متحدث بصوته هو ومزامنة شفاهه في اللقطات القريبة مع الكلام الجديد. وهي عملية توليد طويلة، حتى نحو 13 دقيقة لكل دقيقة من الفيديو، ومبلغها المخصوم تقدير عند البدء يُسوّى إلى ما أنفقه التشغيل.

اختيار النموذجCopy Anchor Link

إذا أغفلت model_id، فسيعمل الفيديو على نموذج الدبلجة الافتراضي لمؤسستك، وهو Morphic Dub في الخطط المدفوعة. سمِّ mdl_h2z5a7af7y50 لتثبيته. ويُرفض الملف الصوتي، أو الفيديو الأطول من 10 دقائق، على Morphic Dub بـ 422 مع ذكر الحد؛ فأرسل هذه إلى ElevenLabs Dubbing.

المدخلاتCopy Anchor Link

يُرفض الفيديو الذي لا يحتوي على مسار صوتي، أو target_language المساوية لـ source_language التي ضبطتها، قبل خصم أي شيء.

تعيين الأصوات، وإحضار نص التفريغ أو الترجمة الخاص بكCopy Anchor Link

افتراضيًا يحتفظ كل متحدث بصوته هو ويتولى Morphic تفريغ الكلام وترجمته. ومع voice_mode: "assigned" ينطق كل شخص بصوت من كتالوج أصوات Morphic بدلًا من ذلك، ويمكنك تسليم نصك الخاص. على Morphic Dub، يحتاج نص التفريغ أو الترجمة الخاص بك إلى assigned: تُدبلج الأصوات الأصلية في مرحلة واحدة لا تستقبل طاقمًا ولا نصًا، ويُرفض الاستدعاء الذي يرسل أيًا منهما مع original بـ 422 مع ذكر الحقل.

1. اسرد الأصوات التي يمكن للدبلجة تعيينها: list_voices مع model_id: "mdl_h2z5a7af7y50". لا تحتاج إلى نطاق وتعيد voice_id كل صوت. أصوات الكتالوج فقط؛ ويُرفض أي صوت من أصوات مؤسستك
2. للمتحدث المسمّى بصورة وجه أو مقطع، مرّر معرّف الأصل أو عنوان HTTPS الخاص به في speaker_asset_id؛ وإلا فصفه في speaker_description (حتى 120 حرفًا، دون أي من ; أو = أو "). واحد فقط من الاثنين لكل عنصر، وكل متحدث مرة واحدة؛ ويحصل المتحدثون الذين تغفلهم على صوت مناسب من الكتالوج
3. لملف SRT الخاص بك، مرّر عنوان HTTPS الخاص به أو معرّف مستند SRT موجود مسبقًا في مكتبتك (تعرضه list_assets) في source_transcript_asset_id (اللغة المنطوقة) أو translation_asset_id (لغة الهدف)؛ ويُضاف العنوان إلى المشروع كمستند قبل بدء الدبلجة، مثل أي ملف عبر عنوان URL آخر. يستقبل الحقلان ملفين مختلفين

{
  "input": {
    "media_asset_id": "01928f4e-…",
    "target_language": "es",
    "voice_mode": "assigned",
    "voices": [
      { "speaker_asset_id": "https://cdn.example.com/host-face.jpg", "voice_id": "0192b1c0-…" },
      { "speaker_description": "the narrator", "voice_id": "0192b1c1-…" }
    ],
    "source_transcript_asset_id": "https://cdn.example.com/interview.en.srt",
    "translation_asset_id": "https://cdn.example.com/interview.es.srt",
    "model_id": "mdl_h2z5a7af7y50",
    "project_id": "01928f4e-…"
  }
}

يُحتسب وضعا الأصوات كلاهما بالسعر نفسه.

عبر MCP يعمل حقلا SRT على ElevenLabs Dubbing أيضًا، مع model_name: "ElevenLabs Dubbing" ودون أصوات: يحتفظ كل متحدث بصوته هو، وsource_language مطلوب، لأن المحرك لا يستطيع اكتشاف اللغة من نص تفريغ، ولا يأتي translation_asset_id إلا بجانب source_transcript_asset_id، مع إشارة مترجمة تقابل كل إشارة في نص التفريغ. وعندما تبدأ معظم الإشارات بتسمية متحدث، مثل Mira: …، تحدد التسميات من يتحدث ومتى، صوت واحد لكل متحدث. لا يملك ElevenLabs Dubbing معرّف model_id، لذا تعمل الدبلجة بنصك الخاص عبر Direct API على Morphic Dub.

احصل على عرض سعر أولًاCopy Anchor Link

تُسعَّر الدبلجة على طول المصدر، لكل لغة. تسعّر plan_media الاستدعاء دون بدئه؛ وعلى Morphic Dub يكون عرض السعر هو التقدير الذي سيُخصم عند البدء، والذي قد تغيّره التسوية لاحقًا.

{
  "input": {
    "steps": [
      { "id": "dub", "tool_name": "dub_media", "arguments_json": "{\"media_asset_id\":\"01928f4e-…\",\"target_language\":\"hi\",\"model_id\":\"mdl_h2z5a7af7y50\"}" }
    ]
  }
}

انظر احصل على عرض سعر قبل الإنفاق للاطّلاع على الاستدعاء الكامل.

بدء الدبلجةCopy Anchor Link

curl -s https://mcp.morphic.com/v1/direct/tools/dub_media \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: dub-interview-hi-1" \
  -d '{
        "input": {
          "media_asset_id": "https://cdn.example.com/interview.mp4",
          "target_language": "hi",
          "keyterms": ["Arjun", "Meera"],
          "model_id": "mdl_h2z5a7af7y50",
          "project_id": "01928f4e-…"
        }
      }'

الاستجابة هي 202 Accepted:

{
  "result": {
    "generation_id": "0192a7b3-a1c4-7e02-8f9d-1a2b3c4d5e6f",
    "status": "queued",
    "model_id": "mdl_h2z5a7af7y50",
    "estimated_credits": 580,
    "credits_settle_on_output_duration": true
  },
  "billing": { "credits_charged": 580, "credits_are_final": false }
}

estimated_credits هو التقدير المخصوم الآن؛ ويعني credits_settle_on_output_duration: true أنه سيُسوّى.

متابعة عملية التوليدCopy Anchor Link

تستغرق الدبلجة على Morphic Dub حتى نحو 13 دقيقة لكل دقيقة من الفيديو، ويستغرق المقطع القصير أطول مما توحي به هذه النسبة، لأن المراحل الثابتة تكلّف الوقت نفسه مهما كان الطول: استغرق مقطع مدته 50 ثانية 17 دقيقة. لا تستطلع من البداية. انتظر نحو 13 ضعف طول المقطع، ثم اقرأ بانتظار طويل وزِد فترات الانتظار تدريجيًا انطلاقًا من poll_after_seconds التي تحملها كل قراءة.

sleep 660   # a 50 s clip: about 13 times its length
curl -s "https://mcp.morphic.com/v1/direct/generations/$GENERATION_ID?wait=45" \
  -H "Authorization: Bearer $MORPHIC_API_KEY"

يغنيك الويبهوك عن حلقة الاستطلاع: مرّر webhook_id مسجّلًا في نص الاستدعاء، ويستدعي Morphic نقطة النهاية الخاصة بك عندما تصبح الدبلجة نهائية. استخدم الويبهوك إشارةً رئيسية والاستطلاع من حين لآخر شبكةَ أمان.

عندما تصبح عملية التوليد succeeded، تحمل assets الخاصة بها الفيديو المدبلج. وتُضبط notice في الاستجابة عندما تعمل الدبلجة على مدخل غير الذي أُعطي، مثل نسخة إقليمية دُبلجت بلغتها الرئيسية.

التكلفةCopy Anchor Link

يُحتسب Morphic Dub على طول المصدر بأسعار API الخاصة بمؤسستك، لكل لغة:

1. عند البدء، يُخصم التقدير: estimated_credits، وهو أيضًا billing.credits_charged
2. عند اكتمال الدبلجة، يُسوّى المبلغ المخصوم إلى ما أنفقه التشغيل فعليًا. وقد يكون المبلغ المسوّى أقل من التقدير أو أكثر منه، لكنه لا يتجاوز ثلاثة أضعافه أبدًا؛ وما زاد على ذلك يتحمّله Morphic
3. بعد أن تصبح عملية التوليد نهائية، يكون billing.credits_charged هو المبلغ الصافي المسوّى، ويكون credits_are_final هو true. وتُسترد تكلفة الدبلجة التي تفشل أو تُلغى بالكامل

اقرأ عملية التوليد مجددًا بعد أن تصبح نهائية للاطّلاع على المبلغ المسوّى؛ ولا يُرسل الويبهوك إلا بعد ذلك. انظر الأرصدة والاستخدام للاطّلاع على السجل.

إذا واجهت أي مشكلة أو كانت لديك أي أسئلة، فلا تتردد في التواصل معنا. يسعدنا مساعدتك. اكتب لنا على support@morphic.com.