Hoppa till innehåll

Sam Audio · Span Separate

Integrera

Modell-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"

Filer som exemplet: 0,05 $ 50 API-krediter dina filer mäts innan körningen Kör den på den här sidan

Hämta API-nyckel
Meta Ljud 10–60 s #audio-to-audio#sam-audio

Isolerar ett ljud från en ljudfil med tidsintervall som du anger, med en valfri texthänvisning

Meta · Data (JSON)

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

Hjälp för ljudidentifiering vid extrahering av ljud från intervallet. En textbeskrivning av ljudet som ska isoleras rekommenderas, men är inte obligatorisk.

•obligatoriskt audio_url
Släpp en fil eller

Ljudfil-URL för bearbetning.

standard 1

Antal kandidater som endast används med en textprompt: så många kandidater genereras och rangordnas. Separation som enbart baseras på intervall ignorerar denna inställning.

•obligatoriskt

Tidsintervall som innehåller målljudet som ska isoleras.

Avancerat acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration standard balanced

Accelerationsnivå som tillämpas på bearbetningen.

output_format standard wav

Format för det genererade ljudet.

standard 60

Ljudgräns per pass, mätt i sekunder, över vilken bearbetningen använder överlappande delar som blandas samman.

standard 5

Överlappningens längd mellan delar, mätt i sekunder, som används för crossfade-blandning.

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

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Sam Audio · Span Separate

I stället för att enbart förlita dig på text skickar du `spans` som markerar när målljudet förekommer i `audio_url`. En `prompt` är valfri men hjälper till att identifiera ljudtypen. `trim_to_span` kan beskära utdata till intervallets längd, och `use_sound_activity_ranking` tillåter omrankning utan prompt. Returnerar `target`- och `residual`-ljud i wav eller mp3.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
audio_urlobligatoriskt audio
Typurl · audio
Ljudfil-URL för bearbetning.
promptvalfritt
Typstring | null
Hjälp för ljudidentifiering vid extrahering av ljud från intervallet. En textbeskrivning av ljudet som ska isoleras rekommenderas, men är inte obligatorisk.
spansobligatoriskt
Typobject[]
Tidsintervall som innehåller målljudet som ska isoleras.
spans[].startobligatoriskt
Typnumber
≥ 0
Starttidsstämpel för intervallet, mätt i sekunder.
spans[].endobligatoriskt
Typnumber
≥ 0
Sluttidsstämpel för intervallet, mätt i sekunder.
spans[].includevalfritt
Typboolean
Standardtrue
Inkludering av ljud inom intervallet: True inkluderar dem, medan False utesluter dem.
reranking_candidatesvalfritt
Typinteger
Standard1
1 – 7
Antal kandidater som endast används med en textprompt: så många kandidater genereras och rangordnas. Separation som enbart baseras på intervall ignorerar denna inställning.
accelerationvalfritt
Typenum
Standardbalanced
fastbalancedquality
Accelerationsnivå som tillämpas på bearbetningen.
max_chunk_durationvalfritt
Typnumber
Standard60
10 – 60
Ljudgräns per pass, mätt i sekunder, över vilken bearbetningen använder överlappande delar som blandas samman.
chunk_overlapvalfritt
Typnumber
Standard5
0 – 30
Överlappningens längd mellan delar, mätt i sekunder, som används för crossfade-blandning.
use_sound_activity_rankingvalfritt
Typboolean
Standardfalse
Alternativ för rangordning av ljudaktivitet som kräver reranking_candidates > 1 och möjliggör effektiv omrangering för separation som enbart baseras på intervall utan textprompt. Kandidaterna poängsätts efter hur väl deras detekterade icke-tysta regioner överensstämmer med de angivna intervallen.
trim_to_spanvalfritt
Typboolean
Standardfalse
Val av utdatalängd mellan endast det angivna intervallet och hela ljudet. När det aktiveras beskärs ljudet till intervallets tidsomfång; False behåller full längd och isolerar målljudet genom hela ljudet.
output_formatvalfritt
Typenum
Standardwav
wavmp3
Format för det genererade ljudet.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
target
object {url, content_type, file_name, file_size}Målljud extraherat isolerat.
residual
object {url, content_type, file_name, file_size}Ljud som återstår utöver målljudet.
duration
numberUtdata-ljudets längd, mätt i sekunder.
sample_rate
integerSamplingsfrekvens i Hz för ljudutdata.

Fler modeller: Ljud

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/sam-audio/span-separate.md. Alla modeller och guider: https://doitong.com/developers/llms.txt