Siirry sisältöön

Sam Audio · Span Separate

Integroi

Mallin tunniste 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"

Esimerkin kaltaiset tiedostot: 0,05 $ 50 API-krediittiä tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Meta Ääni 10–60 s #audio-to-audio#sam-audio

Eristää äänen audiosta antamiesi aikavälien perusteella ja tukee valinnaista tekstivihjettä

Meta · Data (JSON)

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

Äänen tunnistamista helpottava tieto äänen poimimiseksi jaksosta. Eristettävän äänen tekstikuvausta suositellaan, mutta sitä ei vaadita.

•pakollinen audio_url
Pudota tiedosto tai

Käsiteltävän äänitiedoston URL-osoite.

oletus 1

Vain tekstikehotteen kanssa käytettävä ehdokkaiden määrä: kyseinen määrä ehdokkaita luodaan ja asetetaan järjestykseen. Pelkkiin jaksoihin perustuva erottelu ohittaa tämän asetuksen.

•pakollinen

Eristettävää kohdeääntä sisältävät aikavälit.

Lisäasetukset acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration oletus balanced

Käsittelyssä käytetty kiihdytystaso.

output_format oletus wav

Luodun äänen muoto.

oletus 60

Kunkin käsittelykierroksen ääniraja sekunteina; sen ylittyessä käsittely käyttää päällekkäisiä, toisiinsa sekoitettuja osia.

oletus 5

Osien välisen päällekkäisyyden pituus sekunteina ristihäivytyksen sekoitusta varten.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Sam Audio · Span Separate

Pelkkään tekstiin tukeutumisen sijaan annat `spans`-arvot, jotka merkitsevät kohdeäänen esiintymisajat `audio_url`-tiedostossa. `prompt` on valinnainen, mutta auttaa tunnistamaan äänityypin. `trim_to_span` voi rajata tulosteen aikavälille, ja `use_sound_activity_ranking` mahdollistaa uudelleenjärjestämisen ilman kehotetta. Palauttaa `target`- ja `residual`-äänet wav- tai mp3-muodossa.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
audio_urlpakollinen audio
Tyyppiurl · audio
Käsiteltävän äänitiedoston URL-osoite.
promptvalinnainen
Tyyppistring | null
Äänen tunnistamista helpottava tieto äänen poimimiseksi jaksosta. Eristettävän äänen tekstikuvausta suositellaan, mutta sitä ei vaadita.
spanspakollinen
Tyyppiobject[]
Eristettävää kohdeääntä sisältävät aikavälit.
spans[].startpakollinen
Tyyppinumber
≥ 0
Jakson alkuaikaleima sekunteina.
spans[].endpakollinen
Tyyppinumber
≥ 0
Jakson loppuaikaleima sekunteina.
spans[].includevalinnainen
Tyyppiboolean
Oletustrue
Jakson sisällä olevien äänien sisällyttäminen: True sisällyttää ne ja False jättää ne pois.
reranking_candidatesvalinnainen
Tyyppiinteger
Oletus1
1 – 7
Vain tekstikehotteen kanssa käytettävä ehdokkaiden määrä: kyseinen määrä ehdokkaita luodaan ja asetetaan järjestykseen. Pelkkiin jaksoihin perustuva erottelu ohittaa tämän asetuksen.
accelerationvalinnainen
Tyyppienum
Oletusbalanced
fastbalancedquality
Käsittelyssä käytetty kiihdytystaso.
max_chunk_durationvalinnainen
Tyyppinumber
Oletus60
10 – 60
Kunkin käsittelykierroksen ääniraja sekunteina; sen ylittyessä käsittely käyttää päällekkäisiä, toisiinsa sekoitettuja osia.
chunk_overlapvalinnainen
Tyyppinumber
Oletus5
0 – 30
Osien välisen päällekkäisyyden pituus sekunteina ristihäivytyksen sekoitusta varten.
use_sound_activity_rankingvalinnainen
Tyyppiboolean
Oletusfalse
Ääniaktiivisuuden järjestysasetus, joka edellyttää arvoa reranking_candidates > 1 ja mahdollistaa tehokkaan uudelleenjärjestämisen pelkkiin jaksoihin perustuvassa erottelussa ilman tekstikehotetta. Ehdokkaat pisteytetään sen mukaan, kuinka hyvin niiden havaitut äänettömät alueet vastaavat toimitettuja jaksoja.
trim_to_spanvalinnainen
Tyyppiboolean
Oletusfalse
Tulostepituuden valinta määritetyn jakson ja koko äänen välillä. Käyttöönotto rajaa tulosteen jakson aikaväliin; False säilyttää koko pituuden ja eristää kohdeäänen koko ajan.
output_formatvalinnainen
Tyyppienum
Oletuswav
wavmp3
Luodun äänen muoto.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
target
object {url, content_type, file_name, file_size}Eristettynä poimittu kohdeääni.
residual
object {url, content_type, file_name, file_size}Kohdeäänestä jäljelle jäävä ääni.
duration
numberTulosteäänen pituus sekunteina.
sample_rate
integerTulosteäänen näytteenottotaajuus hertseinä.

Lisää malleja: Ääni

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/sam-audio/span-separate.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt