Introdução
Separe uma gravação existente em voz e áudio de fundo com uma única solicitação. Use as duas faixas separadas para praticar música, editar narrações ou fazer uma nova mixagem.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Áudio |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
audio_url | Sim | A gravação mixada a separar, fornecida como URL de áudio. O controle de upload aceita MP3 ou WAV. pelo menos 1 caracteres |
Preços
$0.0012 / segundo
A cobrança ocorre uma única vez por segundo de áudio de entrada, com arredondamento para cima ao segundo inteiro. As duas faixas estão incluídas na mesma cobrança por duração. Este endpoint aceita de 1 a 600 segundos.
Casos de uso
Texto → audio-separation → Áudio
audio-separation
Áudio
Tarefa assíncrona
Guia de prompt e dicas práticas
Introdução
O Vocal Isolator separa uma gravação de áudio existente em uma faixa de voz e uma faixa de fundo. Envie a gravação mixada por audio_url; não é necessário um prompt nem uma tarefa de música gerada anteriormente. Este endpoint serve para trabalhar com sons que você já tem, como o ensaio de uma música, um clipe narrado ou uma gravação de podcast com música de fundo.
Principais recursos e destaques
Duas faixas separadas de uma gravação
A tarefa foi feita para retornar as duas partes da mesma fonte: primeiro a voz e depois o fundo restante. Na música, o fundo é o acompanhamento instrumental. Em uma gravação de fala, ele pode incluir música e som ambiente. São faixas relacionadas de um único processamento, e não duas gerações alternativas para escolher. A separação pode deixar vazamento de som audível ou remover detalhes que se sobrepõem nas duas partes.
A duração da fonte define a quantidade cobrada
A cobrança segue a duração da gravação de entrada, arredondada para cima ao segundo inteiro. Receber duas faixas não dobra essa duração. Este endpoint aceita gravações de 1 a 600 segundos. Ele não oferece ajuste de duração de saída desejada, seletor de falante ou configuração de codec de saída. Guarde a mixagem original junto com os dois resultados para comparar a separação sem perder a gravação de partida.
Casos de uso
Preparar uma faixa para praticar música
Use a faixa de fundo para ensaiar com seu próprio acompanhamento e guarde a faixa de voz para conferir o fraseado. Ouça tanto as pausas quanto os trechos de maior volume: reverberação e vocais de apoio podem permanecer no acompanhamento. Compare em níveis de escuta semelhantes antes de decidir se uma faixa é adequada para o ensaio.
Separar a narração de uma mixagem existente
Em um clipe com fala sobre música, ouça o resultado de voz antes de colocá-lo em uma nova edição. A faixa de fundo pode ser útil como referência de edição, mas não há garantia de que contenha apenas música. Ao comparar no editor, mantenha as duas faixas alinhadas ao mesmo início da fonte.
Guia de prompts e dicas práticas
Preparar a gravação de origem
Não há prompt para ajustar. Envie a versão mais nítida da gravação mixada que você tem, em vez de uma gravação da reprodução em alto-falantes ou de uma cópia com compressão extra. Use MP3 ou WAV pelo controle de upload. Este endpoint processa o arquivo fornecido por inteiro; prepare antes um clipe de origem separado se precisar apenas de parte de uma gravação mais longa. Preserve o original e dê nomes distintos às faixas derivadas.
Conferir as duas faixas antes de usar
Confira as consoantes da fala, as notas sustentadas, o silêncio entre as frases e os canais esquerdo e direito. Ouça se há som musical vazando para a voz ou voz restante no fundo. Não presuma que somar as faixas novamente reconstrói o original com exatidão. Meça as durações reais antes de editar sequências longas e verifique o alinhamento no editor de destino. O formato de saída, a taxa de amostragem e a qualidade da separação ainda precisam ser validados com seu material.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.