Introdução
Envie o texto a ser lido e, opcionalmente, uma das nove vozes, uma breve nota sobre a interpretação e um idioma. A tarefa retorna um arquivo MP3 (mono, 24 kHz) com o roteiro lido nessa voz. instructions recebe direção em linguagem simples, como tom, emoção ou ritmo, e não é falado em voz alta. A SpicyAPI não aplica nenhum filtro de conteúdo: roteiros NSFW são lidos exatamente como estão escritos. Você é cobrado a cada 1.000 caracteres do texto que envia, com um mínimo de 100 caracteres.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Áudio |
| Campo obrigatório | text — de 1 a 2.000 caracteres |
| Campos opcionais |
|
| Resultado | Um arquivo MP3, 24 kHz, mono |
| Quantidade cobrada | Caracteres de text enviados, a cada 1.000; mínimo 100 |
| Tempo típico | Cerca de 30 segundos para 300 caracteres |
| Retenção | O áudio gerado é mantido por 14 dias |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
text | Sim | As palavras a serem faladas, exatamente como escritas. Cobrado a cada 1.000 caracteres, com um mínimo de 100 por solicitação. pelo menos 1 caracteres · no máximo 2000 caracteres |
voice_id | Não | Uma das nove vozes prontas. Padrão: Serena. |
instructions | Não | Direção em linguagem simples sobre tom, emoção ou ritmo. Molda a interpretação e não é falado. no máximo 1000 caracteres |
language | Não | Idioma da leitura. auto detecta a partir do roteiro. |
Preços
$0.068 / 1.000 caracteres
Cobrado a cada 1.000 caracteres do texto enviado, contando espaços e pontuação, com um mínimo de 100 caracteres por solicitação. O orçamento mostrado antes da execução é o preço final.
Casos de uso
Vozes de personagens e companhia
Nove vozes distintas — de claras e ousadas a graves e suaves — cada uma com uma nota curta sobre como fala, mantida igual durante toda uma série.
Falas em chinês, japonês e coreano
Dylan e Eric falam os dialetos de Pequim e de Sichuan, e Ono_Anna e Sohee são vozes nativas em japonês e coreano, então as falas nesses idiomas soam naturais em vez de sotaque.
Histórias em áudio sem censura
Roteiros NSFW são lidos exatamente como estão escritos. Em nossos testes, o modelo falou cada palavra dos monólogos e das narrações que enviamos, sem pular nada e sem cortar o clipe antes do tempo.
Trilhas de voz para vídeo
Gere a fala aqui e depois entregue o MP3 a um modelo de talking-avatar ou lip-sync para que um rosto a interprete.
Guia de prompt e dicas práticas
Envie o roteiro em text
Escreva-o exatamente como deve ser falado, com pontuação para as pausas. Até 2.000 caracteres; abaixo de 100 é cobrado como 100.
Escolha uma voz
voice_idusa Serena por padrão, uma voz feminina calorosa e suave. Ryan e Aiden são vozes masculinas em inglês; Ono_Anna e Sohee são japonesa e coreana; Dylan e Eric falam os dialetos de Pequim e de Sichuan.Descreva a interpretação
Escreva uma ou duas frases em instructions — por exemplo 'ofegante e provocante, perto do microfone'. Esse texto não é falado em voz alta.
O que ele retorna
Um arquivo MP3 por tarefa, mono de 24 kHz. 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.
Escolhendo uma voz
voice_id aceita uma das nove vozes prontas e usa Serena por padrão:
Serena— voz feminina jovem, calorosa e suaveVivian— voz feminina jovem, clara e um pouco ousadaUncle_Fu— voz masculina experiente, com timbre grave e suaveRyan— voz masculina dinâmica, com forte impulso rítmicoAiden— voz masculina americana animadaOno_Anna— voz feminina japonesa brincalhonaSohee— voz feminina coreana calorosa e emotivaDylan— voz masculina jovem que fala o dialeto de PequimEric— voz masculina animada que fala o dialeto de Sichuan (Chengdu)
Dirigindo a interpretação
instructions recebe uma ou duas frases em linguagem simples sobre como ler: tom, emoção, ritmo. Isso molda a performance e não é falado. Controles de velocidade e tom não são expostos; peça-os em instructions.
Idioma
language usa auto por padrão, que detecta o idioma a partir do roteiro. Defina zh, en, de, fr, es, it, pt, ru, ja ou ko quando um roteiro curto ou com vários idiomas for lido no idioma errado.
Cobrança
Cobrado a cada 1.000 caracteres de text, contando espaços, pontuação e quebras de linha, com um mínimo de 100 caracteres por solicitação; instructions é gratuito. A quantidade de caracteres é conhecida antes do início da tarefa, então o orçamento é a cobrança final. Solicitações que falham 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.
A SpicyAPI não adiciona nenhum filtro de conteúdo: roteiros NSFW são lidos exatamente como estão escritos. 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": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Serena"
}
}'
# 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.





