StemSplit API: Integra la Separazione degli Stem AI nelle Tue App

L'API StemSplit è disponibile pubblicamente. Se stai costruendo un'app karaoke, automatizzando l'estrazione degli stem per una libreria musicale, o aggiungendo la rimozione vocale a una pipeline di produzione, ora puoi farlo in modo programmatico.

L'API offre la stessa qualità di separazione AI dell'app web — stesso modello HTDemucs FT, stessa infrastruttura di elaborazione — attraverso semplici endpoint REST con notifiche webhook e supporto diretto per URL YouTube.

Cosa Puoi Costruire

Separazione degli Stem da Qualsiasi Audio

Carica file MP3, WAV, FLAC o M4A ed estrai:

Elabora Video YouTube Direttamente

Passa un URL YouTube e ricevi gli stem separati — senza necessità di scaricare prima:

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"}'

Notifiche Webhook

Registra un endpoint webhook e ricevi un POST quando i job sono completati, invece di fare polling:

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

I payload webhook includono firme HMAC-SHA256 per la verifica.

---

Pronto per iniziare? Ottieni la tua chiave API — i nuovi account ricevono 10 minuti gratuiti per i test.

---

Come Funziona

Passo 1: Carica l'audio direttamente tramite presigned URL, o passa un sourceUrl che punta a un file esistente.

Passo 2: Crea 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"
  }'

Passo 3: Ricevi i risultati tramite webhook o esegui polling sull'endpoint di stato del job. Scarica gli stem dagli URL forniti una volta che il job è completato. Il tempo di elaborazione tipico è 1–3 minuti a seconda della durata dell'audio e dell'impostazione di qualità.

Esempio: Generatore di Karaoke in 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)

Questa è la logica completa per un generatore di karaoke — circa 30 righe dalla chiamata API all'URL di download.

Guide all'Integrazione

La documentazione copre i casi d'uso più comuni:

Riferimento Tecnico

Autenticazione

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx

Genera le chiavi in Impostazioni → API Keys. Ogni account supporta fino a 5 chiavi attive.

Limiti di Rate e Vincoli

Formati Supportati

Input: MP3, WAV, FLAC, M4A, OGG, WebM

Output: MP3, WAV, FLAC (specificare nella richiesta del job)

Impostazioni di Qualità

Prezzi

L'API usa lo stesso sistema di crediti dell'app web — nessun prezzo API separato, nessun abbonamento richiesto. I crediti vengono acquistati secondo necessità e non scadono mai. I nuovi account ricevono 10 minuti gratuiti per i test. Le tariffe attuali sono nella pagina dei prezzi.

Documentazione

• Guida Introduttiva — Avvio rapido con esempi di codice in cURL, Python e JavaScript
• Riferimento API — Documentazione completa degli endpoint con schemi di richiesta e risposta
• Guide all'Integrazione — Tutorial passo-passo per piattaforme e casi d'uso specifici

Domande Frequenti

Qual è la differenza con l'app web? Stesso modello AI, stessa qualità, stessi crediti — l'API fornisce accesso programmatico per automazione e integrazione. L'app web è per l'elaborazione individuale occasionale.

Ho bisogno di un abbonamento? No. Acquista crediti quando ne hai bisogno. Non scadono.

Posso usarlo in prodotti commerciali? Sì. L'API è pensata per l'integrazione in prodotti e flussi di lavoro. I tuoi crediti pagano per l'elaborazione.

Come gestisco i webhook in modo sicuro? Verifica la firma HMAC-SHA256 su ogni payload webhook usando la tua API key come segreto. Rifiuta qualsiasi richiesta che non valida. I dettagli si trovano nel riferimento API.

Posso elaborare video, non solo audio? L'API elabora l'audio. Per gli URL YouTube, estraiamo automaticamente la traccia audio. Per i file video, estrai prima l'audio e invialo.

---

Inizia a Costruire

1. Crea un account
2. Genera una chiave API
3. Leggi la documentazione

I nuovi account includono 10 minuti gratuiti. Non è richiesta la carta di credito per i test.

Ottieni la Tua Chiave API →