تخطّي إلى المحتوى

MMAudio V2

التكامل

معرّف النموذج mmaudio-v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/mmaudio-v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/dev-api/2026/10/21/req_qicb9wfr7rqfo46hqcxollq6/0-QQGxyL6x8ywkCEWdZ94UY_YyJVjs3R.mp4",
    "prompt": "Gentle waves lapping against a wooden boat, oars creaking, seagulls calling in the distance, light wind",
    "duration": 5
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.005 $⁩ 5 أرصدة API تشغيله في هذه الصفحة

الحصول على مفتاح API
Sony AI الصوت 1–30 ث #sound-effects#foley#video-to-audio

إضافة مؤثرات صوتية وأجواء متزامنة إلى فيديو صامت من وصف نصي قصير.

أمثلة

الإدخال
المخرجات · ~20 ث

المطالبةGentle waves lapping against a wooden boat, oars creaking, seagulls calling in the distance, light wind

5 s⁨‏0.005 $⁩ · 5 أرصدة API

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

موجّه يصف الصوت المطلوب إنشاؤه.

•مطلوب video_url
أفلت ملفًا، أو

عنوان URL للفيديو المستخدم مصدرًا لتوليد الصوت.

طول الصوت المُولّد.

متقدم negative_prompt · num_steps · cfg_strength · seed · mask_away_clip
الافتراضي

موجّه سلبي يحدد ما يجب استبعاده أثناء توليد الصوت.

الافتراضي 25

عدد الخطوات المستخدم لتوليد الصوت.

الافتراضي 4.5

شدة Classifier Free Guidance.

قيمة البذرة التي يستخدمها مولّد الأرقام العشوائية.

POST /run/mmaudio-v2?wait=20 عرض السعر → ⁨‏0.005 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/mmaudio-v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/dev-api/2026/10/21/req_qicb9wfr7rqfo46hqcxollq6/0-QQGxyL6x8ywkCEWdZ94UY_YyJVjs3R.mp4",
    "prompt": "Gentle waves lapping against a wooden boat, oars creaking, seagulls calling in the distance, light wind",
    "duration": 5
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول MMAudio V2

يشاهد MMAudio V2 الفيديو وينشئ صوتًا مطابقًا له: خطوات على الإيقاع، ورذاذًا، ومحركات، وحشودًا و أجواء الغرفة، بتوجيه من مطالبتك ومطالبة سلبية اختيارية. ينشئ من 1 إلى 30 ثانية من الصوت و يعيد الفيديو مع مساره الصوتي الجديد.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
video_urlمطلوب video
النوعurl · video
عنوان URL للفيديو المستخدم مصدرًا لتوليد الصوت.
promptمطلوب
النوعstring
موجّه يصف الصوت المطلوب إنشاؤه.
negative_promptاختياري
النوعstring
الافتراضي
موجّه سلبي يحدد ما يجب استبعاده أثناء توليد الصوت.
seedاختياري
النوعinteger | null
0 – 65,535
قيمة البذرة التي يستخدمها مولّد الأرقام العشوائية.
num_stepsاختياري
النوعinteger
الافتراضي25
4 – 50
عدد الخطوات المستخدم لتوليد الصوت.
durationاختياري
النوعnumber
الافتراضي8
1 – 30
طول الصوت المُولّد.
cfg_strengthاختياري
النوعnumber
الافتراضي4.5
0 – 20
شدة Classifier Free Guidance.
mask_away_clipاختياري
النوعboolean
الافتراضيfalse
يتحكم في ما إذا كان المقطع سيُخفى بالقناع.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mmaudio-v2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "prompt": "Night forest ambience, soft paws running on grass, crickets, gentle magical chimes",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}فيديو مخرج يحتوي على حركات شفاه متزامنة.

مزيد من النماذج: الصوت

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/mmaudio-v2.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt