Introduzione
Vocal Isolator separa una registrazione audio esistente in una traccia vocale e una traccia di sottofondo. Invia la registrazione mixata tramite audio_url; non servono un prompt o un’attività di generazione musicale precedente. Questo endpoint serve a lavorare con suoni che hai già, come la prova di una canzone, un clip con narrazione o una registrazione di podcast con musica di sottofondo.
Caratteristiche principali
Due tracce separate da una registrazione
L’attività è pensata per restituire entrambe le parti della stessa sorgente: prima la voce, poi il sottofondo rimanente. Nella musica, il sottofondo è l’accompagnamento strumentale. In una registrazione parlata, può includere musica e suoni ambientali. Sono tracce correlate ottenute con un’unica elaborazione, anziché due generazioni alternative tra cui scegliere. La separazione può lasciare infiltrazioni sonore udibili o rimuovere dettagli che si sovrappongono tra le due parti.
La durata della sorgente determina la quantità fatturata
La fatturazione segue la durata della registrazione in ingresso, arrotondata al secondo intero superiore. Ricevere due tracce non raddoppia tale durata. Questo endpoint accetta registrazioni da 1 a 600 secondi. Non offre impostazioni per richiedere una durata di uscita, selezionare il parlante o scegliere un codec di uscita. Conserva il mix originale insieme a entrambi i risultati per confrontare la separazione senza perdere la registrazione di partenza.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
audio_url | Sì | La registrazione mixata da separare, fornita come URL audio. Il controllo di caricamento accetta MP3 o WAV. almeno 1 caratteri |
Prezzi
$0.0012 / secondo
L’addebito viene applicato una sola volta per secondo di audio in ingresso, arrotondando al secondo intero superiore. Entrambe le tracce sono incluse nello stesso addebito per durata. Questo endpoint accetta da 1 a 600 secondi.
Casi d’uso
Preparare una traccia per esercitarsi con la musica
Usa la traccia di sottofondo per provare con il tuo accompagnamento e conserva la traccia vocale per controllare il fraseggio. Ascolta sia le pause sia i passaggi più forti: riverbero e cori possono rimanere nell’accompagnamento. Confronta a livelli d’ascolto simili prima di decidere se una traccia è adatta alle prove.
Separare la narrazione da un mix esistente
Per un clip con parlato sopra la musica, ascolta il risultato vocale prima di inserirlo in un nuovo montaggio. La traccia di sottofondo può essere utile come riferimento di montaggio, ma non è garantito che contenga soltanto musica. Quando le confronti nell’editor, mantieni entrambe le tracce allineate allo stesso inizio della sorgente.
Consigli avanzati
Preparare la registrazione sorgente
Non c’è un prompt da regolare. Carica la versione più nitida della registrazione mixata che possiedi, anziché una registrazione della riproduzione tramite altoparlanti o una copia ulteriormente compressa. Usa MP3 o WAV tramite il controllo di caricamento. Questo endpoint elabora l’intero file fornito; prepara prima un clip sorgente separato se ti serve solo una parte di una registrazione più lunga. Conserva l’originale e assegna nomi distinti alle tracce derivate.
Controllare entrambe le tracce prima dell’uso
Controlla le consonanti del parlato, le note sostenute, il silenzio tra le frasi e i canali sinistro e destro. Ascolta se nella voce si infiltra della musica o se rimane della voce nel sottofondo. Non dare per scontato che sommando di nuovo le tracce si ricostruisca esattamente l’originale. Misura le loro durate effettive prima di montare sequenze lunghe e verifica l’allineamento nell’editor di destinazione. Il formato di uscita, la frequenza di campionamento e la qualità della separazione richiedono ancora una verifica con il tuo materiale.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/vocal-isolator-v1/audio-separation",
"input": {
"audio_url": "https://example.com/reference.mp3"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.