דילוג לתוכן

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

אורך החפיפה בין המקטעים, נמדד בשניות, ומשמש למיזוג crossfade.

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` יכול לחתוך את הפלט לטווח ה-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
אורך החפיפה בין המקטעים, נמדד בשניות, ומשמש למיזוג crossfade.
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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 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תדירות הדגימה ב-Hz עבור אודיו הפלט.

מודלים נוספים: אודיו

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/sam-audio/span-separate.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt