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

Sam Audio · Span Separate

التكامل

معرّف النموذج sam-audio/span-separate
# 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/sam-audio/span-separate?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",
    "spans": [
      {
        "end": 10,
        "include": true,
        "start": 6
      }
    ]
  }'

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

الحصول على مفتاح API
Meta الصوت 10–60 ث #audio-to-audio#sam-audio

يعزل صوتًا من ملف صوتي باستخدام فترات زمنية تحددها، مع تلميح نصي اختياري

Meta · بيانات (JSON)

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

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

إنشاء طلب

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

أداة مساعدة لتحديد الصوت واستخراجه من المدى. يُوصى بوصف نصي للصوت المراد عزله، لكنه غير مطلوب.

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

عنوان URL لملف صوت لمعالجته.

الافتراضي 1

عدد المرشحين المستخدم فقط مع موجّه نصي: يُنشأ هذا العدد من المرشحين ويُرتَّب. يتجاهل الفصل المعتمد على المدى فقط هذا الإعداد.

•مطلوب

الفواصل الزمنية التي تحتوي على الصوت المستهدف المراد عزله.

متقدم acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration الافتراضي balanced

مستوى التسريع المطبّق على المعالجة.

output_format الافتراضي wav

تنسيق الصوت المُولّد.

الافتراضي 60

حد الصوت لكل تمريرة، مقاسًا بالثواني، وبعده تستخدم المعالجة مقاطع متداخلة تُمزج معًا.

الافتراضي 5

طول التداخل بين المقاطع، مقاسًا بالثواني، والمستخدم للمزج بالتلاشي المتقاطع.

POST /run/sam-audio/span-separate?wait=20 عرض السعر → ⁨‏0.05 $⁩
# 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/sam-audio/span-separate?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",
    "spans": [
      {
        "end": 10,
        "include": true,
        "start": 6
      }
    ]
  }'

# 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

حول Sam Audio · Span Separate

بدل الاعتماد على النص وحده، مرّر `spans` لتحديد أوقات ظهور الصوت المستهدف في `audio_url`. إن `prompt` اختياري لكنه يساعد في تحديد نوع الصوت. يمكن لـ `trim_to_span` قص الناتج إلى نطاق الفترة، ويتيح `use_sound_activity_ranking` إعادة الترتيب دون مطالبة. يعيد صوتي `target` و`residual` بصيغة wav أو mp3.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
audio_urlمطلوب audio
النوعurl · audio
عنوان URL لملف صوت لمعالجته.
promptاختياري
النوعstring | null
أداة مساعدة لتحديد الصوت واستخراجه من المدى. يُوصى بوصف نصي للصوت المراد عزله، لكنه غير مطلوب.
spansمطلوب
النوعobject[]
الفواصل الزمنية التي تحتوي على الصوت المستهدف المراد عزله.
spans[].startمطلوب
النوعnumber
≥ 0
الطابع الزمني لبداية المدى، مقاسًا بالثواني.
spans[].endمطلوب
النوعnumber
≥ 0
الطابع الزمني لنهاية المدى، مقاسًا بالثواني.
spans[].includeاختياري
النوعboolean
الافتراضيtrue
تضمين الأصوات داخل المدى: تتضمنها True، بينما تستبعدها False.
reranking_candidatesاختياري
النوعinteger
الافتراضي1
1 – 7
عدد المرشحين المستخدم فقط مع موجّه نصي: يُنشأ هذا العدد من المرشحين ويُرتَّب. يتجاهل الفصل المعتمد على المدى فقط هذا الإعداد.
accelerationاختياري
النوعenum
الافتراضيbalanced
fastbalancedquality
مستوى التسريع المطبّق على المعالجة.
max_chunk_durationاختياري
النوعnumber
الافتراضي60
10 – 60
حد الصوت لكل تمريرة، مقاسًا بالثواني، وبعده تستخدم المعالجة مقاطع متداخلة تُمزج معًا.
chunk_overlapاختياري
النوعnumber
الافتراضي5
0 – 30
طول التداخل بين المقاطع، مقاسًا بالثواني، والمستخدم للمزج بالتلاشي المتقاطع.
use_sound_activity_rankingاختياري
النوعboolean
الافتراضيfalse
خيار ترتيب نشاط الصوت يتطلب reranking_candidates > 1، ويمكّن إعادة الترتيب الفعالة للفصل المعتمد على المدى فقط دون موجّه نصي. تُقيَّم المرشحات حسب مدى تطابق مناطقها المكتشفة غير الصامتة مع المديات المقدمة.
trim_to_spanاختياري
النوعboolean
الافتراضيfalse
خيار طول المخرج بين المدى المحدد وحده والصوت الكامل. يؤدي تمكينه إلى الاقتصاص وفق النطاق الزمني للمدى؛ بينما تحتفظ False بالطول الكامل وتعزل الصوت المستهدف طواله.
output_formatاختياري
النوعenum
الافتراضيwav
wavmp3
تنسيق الصوت المُولّد.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-audio/span-separate",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "spans": [
      {
        "end": 10,
        "include": true,
        "start": 6
      }
    ]
  },
  "output": {
    "target": {
      "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
    },
    "residual": {
      "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
    },
    "duration": 5,
    "sample_rate": 48000
  },
  "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 هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
target
object {url, content_type, file_name, file_size}الصوت المستهدف المستخرج بصورة معزولة.
residual
object {url, content_type, file_name, file_size}الصوت المتبقي باستثناء الصوت المستهدف.
duration
numberطول الصوت المخرج، مقاسًا بالثواني.
sample_rate
integerتردد أخذ العينات بالهرتز للصوت المخرج.

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

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