Vai al contenuto

Sam Audio · Span Separate

Integra

ID del modello 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 come nell'esempio: 0,05 $ 50 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Meta Audio 10–60 s #audio-to-audio#sam-audio

Isola un suono dall'audio usando intervalli temporali forniti dall'utente, con un suggerimento testuale opzionale

Meta · Dati (JSON)

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

Supporto per identificare il suono da estrarre dall'intervallo. È consigliata, ma non obbligatoria, una descrizione testuale del suono da isolare.

•obbligatorio audio_url
Trascina un file oppure

URL del file audio da elaborare.

predefinito 1

Numero di candidati usato solo con un prompt testuale: viene generato e classificato quel numero di candidati. La separazione basata solo sull'intervallo ignora questa impostazione.

•obbligatorio

Intervalli temporali contenenti il suono target da isolare.

Avanzate acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration predefinito balanced

Livello di accelerazione applicato all'elaborazione.

output_format predefinito wav

Formato dell'audio generato.

predefinito 60

Limite audio per passaggio, misurato in secondi, oltre il quale l'elaborazione usa segmenti sovrapposti che vengono miscelati.

predefinito 5

Durata della sovrapposizione tra i segmenti, misurata in secondi, usata per la miscelazione con crossfade.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Sam Audio · Span Separate

Invece di affidarti solo al testo, passi `spans` che indicano quando il suono target compare in `audio_url`. `prompt` è opzionale, ma aiuta a identificare il tipo di suono. `trim_to_span` può ritagliare l'output sull'intervallo indicato e `use_sound_activity_ranking` consente un nuovo ordinamento senza prompt. Restituisce l'audio `target` e `residual` in wav o mp3.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
audio_urlobbligatorio audio
Tipourl · audio
URL del file audio da elaborare.
promptfacoltativo
Tipostring | null
Supporto per identificare il suono da estrarre dall'intervallo. È consigliata, ma non obbligatoria, una descrizione testuale del suono da isolare.
spansobbligatorio
Tipoobject[]
Intervalli temporali contenenti il suono target da isolare.
spans[].startobbligatorio
Tiponumber
≥ 0
Timestamp iniziale dell'intervallo, misurato in secondi.
spans[].endobbligatorio
Tiponumber
≥ 0
Timestamp finale dell'intervallo, misurato in secondi.
spans[].includefacoltativo
Tipoboolean
Predefinitotrue
Inclusione dei suoni nell'intervallo: True li include, mentre False li esclude.
reranking_candidatesfacoltativo
Tipointeger
Predefinito1
1 – 7
Numero di candidati usato solo con un prompt testuale: viene generato e classificato quel numero di candidati. La separazione basata solo sull'intervallo ignora questa impostazione.
accelerationfacoltativo
Tipoenum
Predefinitobalanced
fastbalancedquality
Livello di accelerazione applicato all'elaborazione.
max_chunk_durationfacoltativo
Tiponumber
Predefinito60
10 – 60
Limite audio per passaggio, misurato in secondi, oltre il quale l'elaborazione usa segmenti sovrapposti che vengono miscelati.
chunk_overlapfacoltativo
Tiponumber
Predefinito5
0 – 30
Durata della sovrapposizione tra i segmenti, misurata in secondi, usata per la miscelazione con crossfade.
use_sound_activity_rankingfacoltativo
Tipoboolean
Predefinitofalse
Opzione di classificazione dell'attività sonora che richiede reranking_candidates > 1 e abilita una riclassificazione efficace per la separazione basata solo sull'intervallo senza prompt testuale. I candidati ricevono un punteggio in base alla corrispondenza tra le regioni rilevate non silenziose e gli intervalli forniti.
trim_to_spanfacoltativo
Tipoboolean
Predefinitofalse
Scelta della lunghezza di output tra il solo intervallo specificato e l'audio completo. Abilitandola, limita l'output all'intervallo temporale; False mantiene la durata completa e isola il suono target ovunque.
output_formatfacoltativo
Tipoenum
Predefinitowav
wavmp3
Formato dell'audio generato.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. 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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
target
object {url, content_type, file_name, file_size}Suono target estratto isolatamente.
residual
object {url, content_type, file_name, file_size}Audio rimanente oltre al suono target.
duration
numberDurata dell'audio di output, misurata in secondi.
sample_rate
integerFrequenza di campionamento in Hz dell'audio di output.

Altri modelli: Audio

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/sam-audio/span-separate.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt