Lompat ke konten

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"

File seperti contoh: $0,05 50 kredit API file Anda diukur sebelum dijalankan Jalankan di halaman ini

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

Mengisolasi suara dari audio menggunakan rentang waktu yang Anda berikan, dengan petunjuk teks opsional

Meta · Data (JSON)

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

Bantuan identifikasi suara untuk mengekstrak audio dari span. Deskripsi teks suara yang akan diisolasi disarankan, tetapi tidak wajib.

•wajib audio_url
Jatuhkan file, atau

URL file audio untuk pemrosesan.

bawaan 1

Jumlah kandidat yang hanya digunakan bersama prompt teks: sebanyak itu kandidat dihasilkan dan diberi peringkat. Pemisahan hanya berdasarkan span mengabaikan pengaturan ini.

•wajib

Interval waktu yang berisi suara target untuk diisolasi.

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

Tingkat akselerasi yang diterapkan pada pemrosesan.

output_format bawaan wav

Format audio yang dihasilkan.

bawaan 60

Batas audio per pass, diukur dalam detik; setelah melewatinya, pemrosesan menggunakan chunk yang saling tumpang tindih dan digabungkan.

bawaan 5

Durasi tumpang tindih antarchunk, diukur dalam detik, yang digunakan untuk penggabungan crossfade.

POST /run/sam-audio/span-separate?wait=20 estimasi 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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Sam Audio · Span Separate

Alih-alih hanya mengandalkan teks, berikan `spans` yang menandai kapan suara target muncul dalam `audio_url`. `prompt` bersifat opsional, tetapi membantu mengidentifikasi jenis suara. `trim_to_span` dapat memotong output sesuai rentang span, dan `use_sound_activity_ranking` memungkinkan pemeringkatan ulang tanpa prompt. Mengembalikan audio `target` dan `residual` dalam wav atau mp3.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
audio_urlwajib audio
Tipeurl · audio
URL file audio untuk pemrosesan.
promptopsional
Tipestring | null
Bantuan identifikasi suara untuk mengekstrak audio dari span. Deskripsi teks suara yang akan diisolasi disarankan, tetapi tidak wajib.
spanswajib
Tipeobject[]
Interval waktu yang berisi suara target untuk diisolasi.
spans[].startwajib
Tipenumber
≥ 0
Stempel waktu awal span, diukur dalam detik.
spans[].endwajib
Tipenumber
≥ 0
Stempel waktu akhir span, diukur dalam detik.
spans[].includeopsional
Tipeboolean
Bawaantrue
Penyertaan suara dalam span: True menyertakannya, sedangkan False mengecualikannya.
reranking_candidatesopsional
Tipeinteger
Bawaan1
1 – 7
Jumlah kandidat yang hanya digunakan bersama prompt teks: sebanyak itu kandidat dihasilkan dan diberi peringkat. Pemisahan hanya berdasarkan span mengabaikan pengaturan ini.
accelerationopsional
Tipeenum
Bawaanbalanced
fastbalancedquality
Tingkat akselerasi yang diterapkan pada pemrosesan.
max_chunk_durationopsional
Tipenumber
Bawaan60
10 – 60
Batas audio per pass, diukur dalam detik; setelah melewatinya, pemrosesan menggunakan chunk yang saling tumpang tindih dan digabungkan.
chunk_overlapopsional
Tipenumber
Bawaan5
0 – 30
Durasi tumpang tindih antarchunk, diukur dalam detik, yang digunakan untuk penggabungan crossfade.
use_sound_activity_rankingopsional
Tipeboolean
Bawaanfalse
Opsi pemeringkatan aktivitas suara yang memerlukan reranking_candidates > 1, sehingga memungkinkan pemeringkatan ulang efektif untuk pemisahan hanya berdasarkan span tanpa prompt teks. Kandidat diberi skor berdasarkan seberapa dekat wilayah nonsilent yang terdeteksi dengan span yang diberikan.
trim_to_spanopsional
Tipeboolean
Bawaanfalse
Pilihan panjang output antara span yang ditentukan saja dan audio lengkap. Jika diaktifkan, output dipangkas ke rentang waktu span; False mempertahankan panjang penuh dan mengisolasi suara target sepanjang audio.
output_formatopsional
Tipeenum
Bawaanwav
wavmp3
Format audio yang dihasilkan.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
target
object {url, content_type, file_name, file_size}Suara target yang diekstrak secara terisolasi.
residual
object {url, content_type, file_name, file_size}Audio yang tersisa selain suara target.
duration
numberPanjang output audio, diukur dalam detik.
sample_rate
integerFrekuensi sampling dalam Hz untuk audio output.

Model lainnya: Audio

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