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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fichiers comme dans l’exemple: 0,05 $ 50 crédits API · ≈ 5,27 ₽ 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 à partir des intervalles temporels fournis, avec un indice textuel facultatif

Meta · Données (JSON)

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

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

•requis audio_url
Déposez un fichier ou

URL du fichier audio à traiter.

par défaut 1

Nombre de candidats utilisé uniquement avec une invite textuelle : ce nombre de candidats est généré et classé. La séparation fondée uniquement sur l’intervalle ignore ce réglage.

•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à, le traitement utilise des segments chevauchants qui 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.ru/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.ru/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 au Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Sam Audio · Span Separate

Plutôt que de s’appuyer uniquement sur le texte, vous transmettez des `spans` indiquant le moment où le son cible apparaît dans `audio_url`. Une `prompt` est facultative, mais aide à identifier le type de son. `trim_to_span` peut rogner la sortie à la plage indiquée, et `use_sound_activity_ranking` permet un reclassement sans invite. 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 facultative.
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 une invite textuelle : ce nombre de candidats est généré et classé. La séparation fondée uniquement sur l’intervalle ignore ce réglage.
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à, le traitement utilise des segments chevauchants qui 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; elle permet un reclassement efficace pour la séparation fondée uniquement sur l’intervalle, sans invite textuelle. Les candidats sont notés selon la correspondance entre leurs régions détectées non silencieuses 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 plage temporelle de l’intervalle; False conserve la durée 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au 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 en dehors 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 en Markdown se trouve à https://doitong.com/fr-CA/developers/models/sam-audio/span-separate.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt