Passer au contenu

Sam Audio · Span Separate

Intégrer

Identifiant du modèle 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"

Fichiers comme dans l’exemple: 0,05 $ 50 crédits API vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Meta audio 10–60 s #audio-to-audio#sam-audio

Isole un son d’un fichier audio à l’aide d’intervalles temporels fournis, avec un indice textuel facultatif

Meta · Données (JSON)

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

Aide à l'identification du son pour extraire l'audio de l'intervalle. Une description textuelle du son à isoler est recommandée, mais pas obligatoire.

•requis audio_url
Déposez un fichier, ou

URL du fichier audio à traiter.

par défaut 1

Nombre de candidats utilisé uniquement avec un prompt textuel : ce nombre de candidats est généré puis classé. La séparation fondée uniquement sur l'intervalle ignore ce paramètre.

•requis

Intervalles temporels contenant le son cible à isoler.

Avancé acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration par défaut balanced

Niveau d’accélération appliqué au traitement.

output_format par défaut wav

Format de l’audio généré.

par défaut 60

Limite audio par passe, mesurée en secondes, au-delà de laquelle le traitement utilise des segments qui se chevauchent et sont fusionnés.

par défaut 5

Durée du chevauchement entre les segments, mesurée en secondes, utilisée pour le fondu enchaîné.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Sam Audio · Span Separate

Au lieu de dépendre uniquement du texte, fournissez `spans` indiquant quand le son cible apparaît dans `audio_url`. Un `prompt` est facultatif, mais aide à identifier le type de son. `trim_to_span` peut limiter la sortie à l’intervalle, et `use_sound_activity_ranking` permet un reclassement sans prompt. Renvoie l’audio `target` et `residual` en wav ou mp3.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
audio_urlrequis audio
Typeurl · audio
URL du fichier audio à traiter.
promptfacultatif
Typestring | null
Aide à l'identification du son pour extraire l'audio de l'intervalle. Une description textuelle du son à isoler est recommandée, mais pas obligatoire.
spansrequis
Typeobject[]
Intervalles temporels contenant le son cible à isoler.
spans[].startrequis
Typenumber
≥ 0
Horodatage de début de l'intervalle, mesuré en secondes.
spans[].endrequis
Typenumber
≥ 0
Horodatage de fin de l'intervalle, mesuré en secondes.
spans[].includefacultatif
Typeboolean
Par défauttrue
Inclusion des sons dans l'intervalle : True les inclut, tandis que False les exclut.
reranking_candidatesfacultatif
Typeinteger
Par défaut1
1 – 7
Nombre de candidats utilisé uniquement avec un prompt textuel : ce nombre de candidats est généré puis classé. La séparation fondée uniquement sur l'intervalle ignore ce paramètre.
accelerationfacultatif
Typeenum
Par défautbalanced
fastbalancedquality
Niveau d’accélération appliqué au traitement.
max_chunk_durationfacultatif
Typenumber
Par défaut60
10 – 60
Limite audio par passe, mesurée en secondes, au-delà de laquelle le traitement utilise des segments qui se chevauchent et sont fusionnés.
chunk_overlapfacultatif
Typenumber
Par défaut5
0 – 30
Durée du chevauchement entre les segments, mesurée en secondes, utilisée pour le fondu enchaîné.
use_sound_activity_rankingfacultatif
Typeboolean
Par défautfalse
Option de classement de l'activité sonore nécessitant reranking_candidates > 1, qui active le reclassement effectif pour la séparation fondée uniquement sur l'intervalle sans prompt textuel. Les candidats sont notés selon la proximité entre leurs régions détectées sans silence et les intervalles fournis.
trim_to_spanfacultatif
Typeboolean
Par défautfalse
Choix de la longueur de sortie entre l'intervalle spécifié seul et l'audio complet. L'activation tronque la sortie à la plage temporelle de l'intervalle ; False conserve la longueur complète et isole le son cible pendant toute la durée.
output_formatfacultatif
Typeenum
Par défautwav
wavmp3
Format de l’audio généré.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
target
object {url, content_type, file_name, file_size}Son cible extrait isolément.
residual
object {url, content_type, file_name, file_size}Audio restant à l'exception du son cible.
duration
numberDurée de la sortie audio, mesurée en secondes.
sample_rate
integerFréquence d’échantillonnage en Hz de l’audio de sortie.

Plus de modèles : audio

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/sam-audio/span-separate.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt