--- title: "StemSplit API: Integra la Separazione degli Stem AI nelle Tue App" date: "2025-01-05" lastUpdated: "2026-03-12" author: "StemSplit Team" tags: ["api", "sviluppatori", "separazione degli stem", "rimozione vocale", "automazione", "webhook", "integrazione"] excerpt: "L'API StemSplit offre agli sviluppatori accesso programmatico alla rimozione vocale e alla separazione degli stem alimentate dall'AI — endpoint REST, webhook, supporto per URL YouTube e lo stesso sistema di crediti pay-per-use dell'app web." abstract: "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." locale: "it" canonical: "https://stemsplit.io/it/blog/stemsplit-api-launch" source: "stemsplit.io" --- > **Source:** https://stemsplit.io/it/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 è 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](/stem-splitter) — 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: | Tipo di Output | Cosa Ottieni | |---|---| | `VOCALS` | Voci isolate | | `INSTRUMENTAL` | Tutto tranne le voci (traccia karaoke) | | `BOTH` | Voci + strumentale come file separati | | `FOUR_STEMS` | Voci, batteria, basso, altro | | `SIX_STEMS` | Voci, batteria, basso, chitarra, pianoforte, altro | ### Elabora Video YouTube Direttamente Passa un URL YouTube e ricevi gli stem separati — senza necessità di scaricare prima: ```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"}' ``` ### Notifiche Webhook Registra un endpoint webhook e ricevi un POST quando i job sono completati, invece di fare polling: ```json { "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](/developers) — i nuovi account ricevono 5 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: ```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" }' ``` **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 ```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: | Piattaforma | Cosa Puoi Costruire | |---|---| | [n8n](/developers/guides/n8n) | Flussi di lavoro automatizzati — elabora file da cloud storage, instrada i risultati su Slack o email | | [Zapier](/developers/guides/zapier) | Automazione no-code che collega StemSplit a 5.000+ app | | [Make](/developers/guides/make) | Costruttore visuale di scenari per flussi di lavoro di elaborazione multi-step | | [Discord Bot](/developers/guides/discord-bot) | Bot di separazione degli stem per server musicali | | [White Label](/developers/guides/white-label) | Incorpora la separazione degli stem nel tuo prodotto con il tuo brand | ## Riferimento Tecnico ### Autenticazione ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxx ``` Genera le chiavi in [Impostazioni → API Keys](/developers). Ogni account supporta fino a 5 chiavi attive. ### Limiti di Rate e Vincoli | Limite | Valore | |---|---| | Richieste al minuto | 60 | | Dimensione massima del file | 50 MB | | Durata massima dell'audio | 60 minuti | | Chiavi API per account | 5 | | Webhook per account | 5 | ### Formati Supportati **Input:** MP3, WAV, FLAC, M4A, OGG, WebM **Output:** MP3, WAV, FLAC (specificare nella richiesta del job) ### Impostazioni di Qualità | Impostazione | Velocità | Caso d'Uso | |---|---|---| | `FAST` | ~20 secondi per minuto di audio | Anteprime rapide, test | | `BALANCED` | ~40 secondi per minuto | Uso generale | | `BEST` | ~60 secondi per minuto | Qualità produttiva; richiesto per 6-stem | ## 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 5 minuti gratuiti per i test. Le tariffe attuali sono nella [pagina dei prezzi](/pricing). ## Documentazione - **[Guida Introduttiva](/developers/docs)** — Avvio rapido con esempi di codice in cURL, Python e JavaScript - **[Riferimento API](/developers/reference)** — Documentazione completa degli endpoint con schemi di richiesta e risposta - **[Guide all'Integrazione](/developers/guides)** — 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](/developers/reference). **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](/free-trial) 2. [Genera una chiave API](/developers) 3. [Leggi la documentazione](/developers/docs) I nuovi account includono 5 minuti gratuiti. Non è richiesta la carta di credito per i test. [Ottieni la Tua Chiave API →](/developers) --- *This article was originally published at https://stemsplit.io/it/blog/stemsplit-api-launch. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*