שפּרינגען צו אינהאַלט

Sam Audio · Span Separate

אינטעגרירן

מאָדעל־id 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 s #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"

לויפֿן דעם ריקוועסט

אײַער 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
לענג פֿון דער איבערלאַפּונג צווישן שטיקלעך, געמאָסטן אין סעקונדעס, פֿאַר אַ גלאַטן קלאַנג־איבערגאַנג.
use_sound_activity_rankingאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
ראַנגירונג־אָפּציע לויט קלאַנג־אַקטיוויטעט וואָס פֿאָדערט reranking_candidates > 1, און דערמעגלעכט עפֿעקטיווע נײַ־ראַנגירונג בײַ אָפּטיילונג נאָר לויט אַן אָפּשניט אָן אַ טעקסט־פּראָמפּט. קאַנדידאַטן באַקומען ציונים לויט ווי נאָענט זייערע דערקענטע נישט־שטילע געגנטן שטימען מיט די צוגעשטעלטע אָפּשניטן.
trim_to_spanאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
ברירה פֿון רעזולטאַט־לענג צווישן נאָר דעם באַשטימטן אָפּשניט און דעם גאַנצן אַודיאָ. דאָס אַקטיווירן שנײַדט אָפּ לויט דעם צײַט־גרענעץ פֿונעם אָפּשניט; False האַלט די גאַנצע לענג און איזאָלירט דעם ציל־קלאַנג דורכאויס.
output_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטwav
wavmp3
פֿאָרמאַט פֿאַר דעם גענערירטן אַודיאָ.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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/yi/developers/models/sam-audio/span-separate.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt