---
title: "API StemSplit : intégrez la séparation de stems IA dans vos applications"
date: "2025-01-05"
lastUpdated: "2026-03-12"
author: "StemSplit Team"
tags: ["api", "développeurs", "séparation de stems", "suppression vocale", "automatisation", "webhooks", "intégration"]
excerpt: "L'API StemSplit offre aux développeurs un accès programmatique à la suppression vocale et à la séparation de stems par IA — endpoints REST, webhooks, support d'URL YouTube et le même système de crédits à l'utilisation que l'application web."
abstract: "L'API StemSplit est disponible publiquement. Si vous construisez une application de karaoké, automatisez l'extraction de stems pour une bibliothèque musicale, ou ajoutez la suppression vocale à un pipeline de production, vous pouvez le faire de manière programmatique dès maintenant."
locale: "fr"
canonical: "https://stemsplit.io/fr/blog/stemsplit-api-launch"
source: "stemsplit.io"
---

> **Source:** https://stemsplit.io/fr/blog/stemsplit-api-launch  
> Originally published by [StemSplit](https://stemsplit.io). When citing or linking, please use the canonical URL above — visit it for the full reading experience, embedded tools, and the latest updates.

L'API StemSplit est disponible publiquement. Si vous construisez une application de karaoké, automatisez l'extraction de stems pour une bibliothèque musicale, ou ajoutez la suppression vocale à un pipeline de production, vous pouvez le faire de manière programmatique dès maintenant.

L'API fournit la même qualité de séparation IA que [l'application web](/stem-splitter) — le même modèle HTDemucs FT, la même infrastructure de traitement — via des endpoints REST simples avec des notifications webhook et un support direct des URL YouTube.

## Ce que vous pouvez créer

### Séparation de stems de n'importe quel audio

Importez des fichiers MP3, WAV, FLAC ou M4A et extrayez :

| Type de sortie | Ce que vous obtenez |
|---|---|
| `VOCALS` | Voix isolées |
| `INSTRUMENTAL` | Tout sauf les voix (piste karaoké) |
| `BOTH` | Voix + instrumental en fichiers séparés |
| `FOUR_STEMS` | Voix, batterie, basse, autres |
| `SIX_STEMS` | Voix, batterie, basse, guitare, piano, autres |

### Traiter des vidéos YouTube directement

Passez une URL YouTube et récupérez des stems séparés — sans avoir à télécharger au préalable :

```bash
curl -X POST https://stemsplit.io/api/v1/youtube-jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"youtubeUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ"}'
```

### Notifications webhook

Enregistrez un endpoint webhook et recevez un POST quand les jobs se terminent, plutôt que d'interroger régulièrement l'API :

```json
{
  "event": "job.completed",
  "timestamp": "2026-01-05T12:30:00Z",
  "data": {
    "jobId": "clxxx123...",
    "status": "COMPLETED",
    "outputs": {
      "vocals": { "url": "https://...", "expiresAt": "..." },
      "instrumental": { "url": "https://...", "expiresAt": "..." }
    }
  }
}
```

Les payloads webhook incluent des signatures HMAC-SHA256 pour la vérification.

---

**Prêt à commencer ?** [Obtenez votre clé API](/developers) — les nouveaux comptes reçoivent 5 minutes gratuites pour tester.

---

## Comment ça fonctionne

**Étape 1 :** Importez l'audio directement via une URL présignée, ou passez une `sourceUrl` pointant vers un fichier existant.

**Étape 2 :** Créez un job :

```bash
curl -X POST https://stemsplit.io/api/v1/jobs \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/song.mp3",
    "outputType": "BOTH",
    "quality": "BEST"
  }'
```

**Étape 3 :** Recevez les résultats via webhook ou interrogez l'endpoint de statut du job. Téléchargez les stems depuis les URL fournies une fois le job terminé. Le temps de traitement typique est de 1 à 3 minutes selon la durée de l'audio et le paramètre de qualité.

## Exemple : générateur de karaoké en Python

```python
import requests
import time

API_KEY = "sk_live_xxx"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

response = requests.post(
    "https://stemsplit.io/api/v1/jobs",
    headers=HEADERS,
    json={
        "sourceUrl": "https://example.com/song.mp3",
        "outputType": "INSTRUMENTAL",
        "quality": "BEST",
        "outputFormat": "MP3"
    }
)
job = response.json()
print(f"Created job: {job['id']}")

while True:
    status = requests.get(
        f"https://stemsplit.io/api/v1/jobs/{job['id']}",
        headers=HEADERS
    ).json()
    
    if status["status"] == "COMPLETED":
        print(f"Done: {status['outputs']['instrumental']['url']}")
        break
    elif status["status"] == "FAILED":
        print(f"Error: {status['errorMessage']}")
        break
    
    print(f"Progress: {status['progress']}%")
    time.sleep(5)
```

C'est la logique complète pour un générateur de karaoké — environ 30 lignes de l'appel API à l'URL de téléchargement.

## Guides d'intégration

La documentation couvre les cas d'utilisation les plus courants :

| Plateforme | Ce que vous pouvez construire |
|---|---|
| [n8n](/developers/guides/n8n) | Workflows automatisés — traitez des fichiers depuis le stockage cloud, envoyez les résultats vers Slack ou e-mail |
| [Zapier](/developers/guides/zapier) | Automatisation sans code connectant StemSplit à plus de 5 000 applications |
| [Make](/developers/guides/make) | Constructeur visuel de scénarios pour des workflows de traitement multi-étapes |
| [Discord Bot](/developers/guides/discord-bot) | Bot de séparation de stems pour les serveurs de musique |
| [White Label](/developers/guides/white-label) | Intégrez la séparation de stems dans votre propre produit sous votre marque |

## Référence technique

### Authentification

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx
```

Générez des clés dans [Paramètres → Clés API](/developers). Chaque compte prend en charge jusqu'à 5 clés actives.

### Limites de débit et contraintes

| Limite | Valeur |
|---|---|
| Requêtes par minute | 60 |
| Taille maximale de fichier | 50 Mo |
| Durée audio maximale | 60 minutes |
| Clés API par compte | 5 |
| Webhooks par compte | 5 |

### Formats supportés

**Entrée :** MP3, WAV, FLAC, M4A, OGG, WebM

**Sortie :** MP3, WAV, FLAC (à spécifier dans la requête de job)

### Paramètres de qualité

| Paramètre | Vitesse | Cas d'utilisation |
|---|---|---|
| `FAST` | ~20 sec. par minute d'audio | Aperçus rapides, tests |
| `BALANCED` | ~40 sec. par minute | Usage général |
| `BEST` | ~60 sec. par minute | Qualité de production ; requis pour 6 stems |

## Tarification

L'API utilise le même système de crédits que l'application web — pas de tarification séparée pour l'API, pas d'abonnement requis. Les crédits sont achetés selon les besoins et n'expirent jamais. Les nouveaux comptes reçoivent 5 minutes gratuites pour tester. Les tarifs actuels sont sur la [page de tarification](/pricing).

## Documentation

- **[Démarrage rapide](/developers/docs)** — Guide de démarrage avec exemples de code en cURL, Python et JavaScript
- **[Référence API](/developers/reference)** — Documentation complète des endpoints avec schémas de requête et réponse
- **[Guides d'intégration](/developers/guides)** — Tutoriels pas à pas pour des plateformes et cas d'utilisation spécifiques

## Foire aux questions

**En quoi est-ce différent de l'application web ?**
Même modèle IA, même qualité, mêmes crédits — l'API fournit un accès programmatique pour l'automatisation et l'intégration. L'application web est pour le traitement individuel ponctuel.

**Ai-je besoin d'un abonnement ?**
Non. Achetez des crédits quand vous en avez besoin. Ils n'expirent pas.

**Puis-je l'utiliser dans des produits commerciaux ?**
Oui. L'API est destinée à l'intégration dans des produits et workflows. Vos crédits paient pour le traitement.

**Comment gérer les webhooks de manière sécurisée ?**
Vérifiez la signature HMAC-SHA256 sur chaque payload webhook en utilisant votre clé API comme secret. Rejetez toute requête qui ne se valide pas. Détails dans la [référence API](/developers/reference).

**Puis-je traiter des vidéos, pas seulement de l'audio ?**
L'API traite l'audio. Pour les URL YouTube, nous extrayons automatiquement la piste audio. Pour les fichiers vidéo, extrayez l'audio d'abord et soumettez-le.

---

## Commencez à construire

1. [Créer un compte](/free-trial)
2. [Générer une clé API](/developers)
3. [Lire la documentation](/developers/docs)

Les nouveaux comptes incluent 5 minutes gratuites. Aucune carte de crédit requise pour tester.

[Obtenir votre clé API →](/developers)

---

*This article was originally published at https://stemsplit.io/fr/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*