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

Demucs

التكامل

معرّف النموذج demucs
# 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/demucs?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# 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.007 $⁩ 7 أرصدة API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Meta الصوت #audio

يقسم مقطعًا موسيقيًا إلى مسارات منفصلة مثل الغناء والطبول والجهير والغيتار والبيانو، مع خيارات متعددة

Meta · بيانات (JSON)

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

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

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

عنوان URL يشير إلى ملف الصوت المطلوب لفصل المسارات.

متقدم model · output_format · segment_length · shifts · overlap · stems
model الافتراضي htdemucs_6s

نموذج Demucs المحدد لفصل المسارات.

output_format الافتراضي mp3

تنسيق الصوت المستخدم لحفظ المسارات المفصولة.

مدة مقطع المعالجة بالثواني، مع قيمة افتراضية خاصة بالنموذج. يؤدي تقليلها إلى خفض استخدام الذاكرة، لكنه قد يقلل الجودة؛ والحد الأدنى هو 1.

الافتراضي 1

عدد الإزاحات العشوائية لتحقيق الاستقرار المتكافئ، مع مقايضة وقت معالجة إضافي بجودة محسّنة كلما زاد العدد.

الافتراضي 0.25

تؤدي زيادة تداخل المقاطع إلى وقت معالجة أطول مقابل جودة محتملة أفضل؛ والنطاق المدعوم هو 0.0–1.0.

الافتراضي ["vocals","drums","ba...

اختيار المسار من الخيارات المتاحة للنموذج: vocals, drums, bass, other, guitar, piano (للنموذج 6s). عيّن القيمة إلى None لاستخراج كل المسارات التي يوفرها النموذج بدلًا من اختيار محدد.

POST /run/demucs?wait=20 عرض السعر → ⁨‏0.007 $⁩
# 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/demucs?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# 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

حول Demucs

يفصل الأغنية إلى مسارات فردية للآلات. اختر نسخة Demucs عبر `model` (الافتراضية htdemucs_6s، التي تنتج أيضًا الغيتار والبيانو)، وحدد المخرجات عبر `stems`، واضبط الجودة باستخدام `shifts` (من 1 إلى 10) و`overlap` (من 0 إلى 1) و`segment_length`. تُرجع المسارات كملفات mp3 أو wav، ملفًا واحدًا لكل مصدر.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
audio_urlمطلوب audio
النوعurl · audio
عنوان URL يشير إلى ملف الصوت المطلوب لفصل المسارات.
modelاختياري
النوعenum
الافتراضيhtdemucs_6s
htdemucshtdemucs_fthtdemucs_6shdemucs_mmimdxmdx_extramdx_qmdx_extra_q
نموذج Demucs المحدد لفصل المسارات.
stemsاختياري
النوعenum[]
الافتراضي["vocals","drums","bass","other","guitar","piano"]
اختيار المسار من الخيارات المتاحة للنموذج: vocals, drums, bass, other, guitar, piano (للنموذج 6s). عيّن القيمة إلى None لاستخراج كل المسارات التي يوفرها النموذج بدلًا من اختيار محدد.
segment_lengthاختياري
النوعinteger | null
≥ 1
مدة مقطع المعالجة بالثواني، مع قيمة افتراضية خاصة بالنموذج. يؤدي تقليلها إلى خفض استخدام الذاكرة، لكنه قد يقلل الجودة؛ والحد الأدنى هو 1.
shiftsاختياري
النوعinteger
الافتراضي1
1 – 10
عدد الإزاحات العشوائية لتحقيق الاستقرار المتكافئ، مع مقايضة وقت معالجة إضافي بجودة محسّنة كلما زاد العدد.
overlapاختياري
النوعnumber
الافتراضي0.25
0 – 1
تؤدي زيادة تداخل المقاطع إلى وقت معالجة أطول مقابل جودة محتملة أفضل؛ والنطاق المدعوم هو 0.0–1.0.
output_formatاختياري
النوعenum
الافتراضيmp3
wavmp3
تنسيق الصوت المستخدم لحفظ المسارات المفصولة.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "demucs",
  "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": 7,
    "usd": "0.007",
    "charged": 7,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "vocals": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "drums": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "bass": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "other": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "guitar": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "piano": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
vocals
object {url, content_type, file_name, file_size} | nullملف صوت يحتوي على الغناء المعزول.
drums
object {url, content_type, file_name, file_size} | nullملف صوت يحتوي على الطبول المعزولة.
bass
object {url, content_type, file_name, file_size} | nullملف صوت يحتوي على الجهير المعزول.
other
object {url, content_type, file_name, file_size} | nullملف صوت يحتوي على الآلات الأخرى المعزولة.
guitar
object {url, content_type, file_name, file_size} | nullملف صوت يحتوي على الغيتار المعزول، ومتاح حصريًا مع نماذج 6s.
piano
object {url, content_type, file_name, file_size} | nullملف صوت يحتوي على البيانو المعزول، ومتاح حصريًا مع نماذج 6s.

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