Langkau ke kandungan

Sam Audio · Span Separate

Integrasikan

ID model 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"

Fail seperti contoh: $0.05 50 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Meta Audio 10–60 s #audio-to-audio#sam-audio

Mengasingkan bunyi daripada audio menggunakan julat masa yang anda berikan, dengan petunjuk teks pilihan

Meta · Data (JSON)

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

Bantuan pengenalpastian bunyi untuk mengekstrak audio daripada rentang. Perihalan teks bunyi yang hendak diasingkan disyorkan tetapi tidak diwajibkan.

•diperlukan audio_url
Lepaskan fail, atau

URL fail audio untuk pemprosesan.

lalai 1

Bilangan calon yang digunakan hanya dengan prompt teks: bilangan calon tersebut dijana dan diperingkat. Pengasingan berdasarkan rentang sahaja mengabaikan tetapan ini.

•diperlukan

Selang masa yang mengandungi bunyi sasaran untuk diasingkan.

Lanjutan acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration lalai balanced

Tahap pecutan yang digunakan pada pemprosesan.

output_format lalai wav

Format untuk audio yang dijana.

lalai 60

Had audio setiap laluan, diukur dalam saat; selepas had ini, pemprosesan menggunakan bahagian bertindih yang digabungkan.

lalai 5

Panjang pertindihan antara bahagian, diukur dalam saat, yang digunakan untuk penggabungan crossfade.

POST /run/sam-audio/span-separate?wait=20 sebut harga → $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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Sam Audio · Span Separate

Daripada bergantung pada teks sahaja, anda menghantar `spans` yang menandakan masa bunyi sasaran berlaku dalam `audio_url`. `prompt` adalah pilihan tetapi membantu mengenal pasti jenis bunyi. `trim_to_span` boleh memotong output kepada julat span, manakala `use_sound_activity_ranking` membenarkan pemeringkatan semula tanpa prompt. Mengembalikan audio `target` dan `residual` dalam wav atau mp3.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
audio_urldiperlukan audio
Jenisurl · audio
URL fail audio untuk pemprosesan.
promptpilihan
Jenisstring | null
Bantuan pengenalpastian bunyi untuk mengekstrak audio daripada rentang. Perihalan teks bunyi yang hendak diasingkan disyorkan tetapi tidak diwajibkan.
spansdiperlukan
Jenisobject[]
Selang masa yang mengandungi bunyi sasaran untuk diasingkan.
spans[].startdiperlukan
Jenisnumber
≥ 0
Cap masa mula rentang, diukur dalam saat.
spans[].enddiperlukan
Jenisnumber
≥ 0
Cap masa tamat rentang, diukur dalam saat.
spans[].includepilihan
Jenisboolean
Lalaitrue
Penyertaan bunyi dalam rentang: True menyertakannya, manakala False mengecualikannya.
reranking_candidatespilihan
Jenisinteger
Lalai1
1 – 7
Bilangan calon yang digunakan hanya dengan prompt teks: bilangan calon tersebut dijana dan diperingkat. Pengasingan berdasarkan rentang sahaja mengabaikan tetapan ini.
accelerationpilihan
Jenisenum
Lalaibalanced
fastbalancedquality
Tahap pecutan yang digunakan pada pemprosesan.
max_chunk_durationpilihan
Jenisnumber
Lalai60
10 – 60
Had audio setiap laluan, diukur dalam saat; selepas had ini, pemprosesan menggunakan bahagian bertindih yang digabungkan.
chunk_overlappilihan
Jenisnumber
Lalai5
0 – 30
Panjang pertindihan antara bahagian, diukur dalam saat, yang digunakan untuk penggabungan crossfade.
use_sound_activity_rankingpilihan
Jenisboolean
Lalaifalse
Pilihan pemeringkatan aktiviti bunyi yang memerlukan reranking_candidates > 1, membolehkan pemeringkatan semula berkesan untuk pengasingan berdasarkan rentang sahaja tanpa prompt teks. Calon diberi skor berdasarkan sejauh mana kawasan senyap yang dikesan sepadan dengan rentang yang dibekalkan.
trim_to_spanpilihan
Jenisboolean
Lalaifalse
Pilihan panjang output antara rentang yang ditentukan sahaja dan audio lengkap. Mendayakannya memangkas kepada julat masa rentang; False mengekalkan panjang penuh dan mengasingkan bunyi sasaran sepanjang audio.
output_formatpilihan
Jenisenum
Lalaiwav
wavmp3
Format untuk audio yang dijana.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
target
object {url, content_type, file_name, file_size}Bunyi sasaran yang diekstrak secara berasingan.
residual
object {url, content_type, file_name, file_size}Audio yang tinggal selain bunyi sasaran.
duration
numberPanjang audio output, diukur dalam saat.
sample_rate
integerKekerapan pensampelan dalam Hz untuk audio output.

Lebih banyak model: Audio

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/sam-audio/span-separate.md. Semua model dan panduan: https://doitong.com/developers/llms.txt