Introdução
Envie até 1.000 caracteres de texto em inglês e, opcionalmente, quão expressiva, variada e rigorosamente guiada a leitura deve ser. A tarefa retorna um arquivo WAV (24 kHz, 16 bits, mono) lido na voz embutida do Chatterbox ou na voz de um clipe curto que você envia em reference_audio_url. Marcações como são lidas em voz alta, então escreva os sons por extenso em vez disso. O SpicyAPI não aplica nenhum filtro de conteúdo: os roteiros sem filtro são lidos como escritos. Cada solicitação custa o mesmo preço fixo.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Áudio |
| Campo obrigatório | text — de 1 a 1.000 caracteres em inglês |
| Campos opcionais | exaggeration (0–1), temperature (0,05–2), |
| Resultado | Um arquivo WAV, 24 kHz, 16 bits, mono |
| Voz | Voz embutida ou clonada a partir de |
| Quantidade cobrada | Um preço fixo por solicitação |
| Retenção | O áudio gerado é mantido por 14 dias |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
text | Sim | Até 1.000 caracteres de inglês, lidos exatamente como escritos. Marcações como são lidas em voz alta; escreva os sons por extenso em vez disso. pelo menos 1 caracteres · no máximo 1000 caracteres |
reference_audio_url | Não | Clipe opcional em MP3 ou WAV da voz a imitar: envie o arquivo ou informe uma URL pública. A leitura assume o timbre desse clipe; as palavras dele não são repetidas. pelo menos 1 caracteres |
exaggeration | Não | Quão emotiva é a leitura, de 0 (neutra) a 1 (dramática). Padrão: 0,5. |
temperature | Não | Variação entre as tomadas, de 0,05 a 2. Padrão: 0,7. |
guidance_scale | Não | Quão rigorosamente a leitura segue o ritmo natural do texto, de 0,1 a 1. Padrão: 0,5; diminua-o para desacelerar uma leitura apressada. |
Preços
$0.036 / solicitação
Um preço fixo por solicitação de até 1.000 caracteres.
Casos de uso
Falas para jogos e animação
Falas de personagem curtas e diretas, em que a energia importa mais do que a escolha do timbre. Aumente exaggeration para falas gritadas, risonhas ou ofegantes.
Vozes de protótipo
Dê voz a uma demo, um storyboard ou um chatbot antes de escolher a voz final, por um preço fixo por linha.
Histórias em áudio sem censura
Os roteiros sem filtro são lidos como escritos. Em nossos testes, o modelo falou cada palavra dos monólogos e das narrações enviados, e também os sons escritos por extenso.
Trilhas de voz para vídeo
Gere a fala aqui e depois passe o WAV para um modelo de avatar falante ou lip-sync para que um rosto a interprete.
Guia de prompt e dicas práticas
Envie o roteiro em texto
Até 1.000 caracteres de inglês, com pontuação para as pausas. Escreva as risadas e os suspiros por extenso: as tags são lidas em voz alta.
Defina a energia
exaggeration usa 0,5 por padrão. Aumente-o para falas dramáticas ou ofegantes, diminua-o para uma narração calma.
Ajuste fino se necessário
Diminua
guidance_scalepara desacelerar uma leitura apressada; aumente temperature para mais variedade entre as tomadas.
O que ele retorna
Um arquivo WAV por tarefa: 24 kHz, 16 bits, PCM mono. O arquivo é copiado para o armazenamento da SpicyAPI e mantido por 14 dias. O resultado não tem marcação de tempo por palavra nem legendas.
A voz
O Chatterbox é o modelo de inglês de código aberto da Resemble AI (licença MIT). Sem referência, ele lê com a voz embutida; não há lista de vozes. Envie um clipe curto em MP3 ou WAV em reference_audio_url para clonar uma voz: a leitura assume o timbre do clipe, não as palavras dele. Funcionam melhor alguns segundos de uma única voz limpa, sem música, e você precisa ter o direito de usar essa voz.
Controles
exaggeration(0–1, padrão 0,5): quão emotiva é a leitura.temperature(0,05–2, padrão 0,7): variação entre as tomadas.guidance_scale(0,1–1, padrão 0,5): quão rigorosamente a leitura segue o ritmo do texto; cerca de 0,3 desacelera uma entrega rápida e dramática.
Em nossos testes, marcações como <laugh>, <sigh> ou [gasp] foram lidas em voz alta como palavras. Em vez disso, escreva os sons por extenso: "ha…", "mmm…", "ahh…".
Duração
text aceita até 1.000 caracteres. Em nossos testes, um parágrafo de 270 caracteres resultou em cerca de 15 segundos de áudio; a maioria das tarefas terminava em 10 a 30 segundos.
Cobrança
Um preço fixo por solicitação. Solicitações com falha não são cobradas.
Conteúdo
A SpicyAPI não adiciona nenhum filtro de conteúdo. Em nossos testes, os roteiros sem filtro foram lidos palavra por palavra, sem pular nada e sem que nenhum clipe terminasse antes do tempo.
O SpicyAPI não adiciona filtro de conteúdo: os roteiros são lidos como escritos, sem nenhum abrandamento. Você é responsável pelos roteiros que envia e pelo uso que faz do áudio resultante, incluindo não apresentá-lo como as palavras de uma pessoa real.
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": "resemble-ai/chatterbox-v1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
}
}'
# 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.
