API StemSplit : intégrez la séparation de stems IA dans vos applications

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 — 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 :

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 :

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 :

{
  "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 — 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 :

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

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 :

Référence technique

Authentification

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

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

Limites de débit et contraintes

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é

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.

Documentation

• Démarrage rapide — Guide de démarrage avec exemples de code en cURL, Python et JavaScript
• Référence API — Documentation complète des endpoints avec schémas de requête et réponse
• Guides d'intégration — 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.

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
2. Générer une clé API
3. Lire la documentation

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

Obtenir votre clé API →