Introdução
Envie o texto a ser lido, uma voz do sistema, uma emoção e, opcionalmente, uma dica de idioma. A tarefa devolve um arquivo de áudio com o roteiro lido nessa voz e emoção: um MP3 mono de 32 kHz, a menos que você defina output_format, sample_rate, bitrate ou audio_channels. speed, pitch e volume ajustam a interpretação, e pronunciation_dict fixa como palavras específicas são lidas. Tags de som entre parênteses, como (sighs) ou (laughs), colocadas no texto são executadas como sons, não lidas em voz alta. A SpicyAPI não aplica nenhum filtro de conteúdo: cada roteiro é lido como escrito. A cobrança é por 1.000 caracteres do texto enviado.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Áudio |
| Campo obrigatório | text — de 1 a 5.000 caracteres |
| Campos opcionais |
|
| Resultado | Um arquivo de áudio: MP3 (32 kHz, mono) por padrão, ou WAV, FLAC, PCM |
| Quantidade cobrada | Caracteres de text enviados, a cada 1.000 |
| Tempo típico | Cerca de 8 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. Marcações sonoras entre parênteses, como (sighs) ou (laughs), são interpretadas como som, não lidas em voz alta. pelo menos 1 caracteres · no máximo 5000 caracteres |
voice_id | Não | Uma das 472 vozes do sistema. Padrão: Calm_Woman. |
emotion | Não | Uma das sete emoções fixas — neutral, happy, sad, angry, fearful, disgusted ou surprised — aplicada a toda a leitura. Padrão: neutral. |
speed | Não | Velocidade da fala de 0,5 (mais lenta) a 2 (mais rápida); 1 é o ritmo normal da voz. Não altera o preço. |
pitch | Não | Deslocamento de tom em semitons, de -12 a 12; 0 mantém o tom natural da voz. Não altera o preço. |
volume | Não | Multiplicador de volume de 0,1 a 10; 1 é o nível normal. Não altera o preço. |
language | Não | Uma indicação que melhora a pronúncia para um dos 40 idiomas. Padrão: auto, que detecta o idioma a partir do roteiro. |
output_format | Não | Formato do arquivo: mp3 (padrão), wav, flac ou pcm, isto é, amostras brutas de 16 bits little-endian sem cabeçalho, no |
sample_rate | Não | Taxa de amostragem do áudio em Hz: 8000, 16000, 22050, 24000, 32000, 44100. Padrão: 32000. |
bitrate | Não | Taxa de bits do MP3 em bits por segundo: 32000, 64000, 128000 ou 256000. Padrão: 128000; só vale quando |
audio_channels | Não | Canais de saída: mono (padrão) ou stereo. Não altera o preço. |
english_normalization | Não | Quando ativado, números, datas e abreviações em texto em inglês são lidos como uma pessoa diria, por exemplo 1990 como “nineteen ninety”. Desativado por padrão. Valor padrão: |
pronunciation_dict | Não | Até 100 pares {alias, pronunciation}. Cada ocorrência de alias em text é lida como pronunciation: palavras comuns (Omg → Oh my god) ou IPA entre parênteses, como (rɪˈzjuːm). no máximo 100 itens |
Preços
$0.12 / 1.000 caracteres
Cobrado a cada 1.000 caracteres do texto enviado, contando espaços e pontuação. O orçamento mostrado antes da execução é o preço final.
Casos de uso
Locução para vídeos curtos
Narração para vídeos explicativos, clipes de produto e publicações em redes sociais. O preço é definido pelo tamanho do roteiro, então você sabe quanto um lote vai custar antes de começar.
Conteúdo multilíngue
Leia o mesmo roteiro indicando um dos 40 idiomas compatíveis, ou deixe language em auto e deixe o roteiro decidir.
Histórias de áudio sem censura
Os roteiros são lidos como escritos, sem filtro de conteúdo. Em nossos testes, o modelo falou cada palavra de monólogos e cenas narradas que outros serviços recusam, executando as indicações de respiração e de som em vez de lê-las em voz alta.
Leituras de personagens com emoção
Defina uma das sete emoções por pedido — happy, sad, angry, fearful, disgusted ou surprised — e deixe que as marcações (sighs), (laughs) ou (breath) no roteiro moldem a interpretação.
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 e marcações sonoras como (sighs) entre parênteses onde quiser que sejam interpretadas. Até 5.000 caracteres.
Escolha uma voz e uma emoção
voice_idusa Calm_Woman por padrão; emotion usa neutral por padrão e aceita um dos sete valores fixos.Adicione um idioma se precisar
Deixe language em auto para detectá-lo a partir do roteiro, ou defina um dos 40 idiomas quando um roteiro curto ou misto precisar de ajuda com a pronúncia.
O que ele retorna
Um arquivo de áudio por tarefa: um MP3 mono de 32 kHz, a menos que você mude output_format, sample_rate, bitrate ou audio_channels. O arquivo é copiado para o armazenamento da SpicyAPI e mantido por 14 dias.
Escolhendo uma voz
voice_id aceita uma das 472 vozes do sistema, como Calm_Woman, Deep_Voice_Man, Lively_Girl ou Elegant_Man, e usa Calm_Woman por padrão. Não há clonagem nem envio de uma voz de referência.
Definindo uma emoção
emotion aceita um dos sete valores fixos — neutral, happy, sad, angry, fearful, disgusted ou surprised — e se aplica a toda a leitura. O padrão é neutral.
Marcações sonoras
Tags entre parênteses dentro de text, como (sighs), (laughs), (breath) ou (gasps), são executadas como sons em vez de lidas em voz alta. Em nossos testes isso valeu tanto para roteiros que outros serviços recusam quanto para roteiros comuns.
Idioma
O idioma é detectado a partir do roteiro. language indica um dos 40 idiomas, incluindo mandarim, cantonês, inglês, árabe, russo, espanhol, francês, português, alemão, japonês, italiano, coreano, polonês e outros, para melhorar a pronúncia de um roteiro curto ou misto.
Controlar a interpretação
speed (0,5–2), pitch (de -12 a 12 semitons) e volume (0,1–10) ajustam a leitura sem alterar o preço. pronunciation_dict aceita até 100 pares {alias, pronunciation}, para que um nome, uma sigla ou um estrangeirismo seja sempre lido do jeito que você quer: com palavras comuns ou em IPA entre parênteses. english_normalization lê números, datas e abreviações em texto em inglês como uma pessoa diria.
Formato de saída
output_format escolhe mp3 (padrão), wav, flac ou pcm; sample_rate vai de 8000 a 44100 Hz, bitrate define a taxa de bits do MP3 e audio_channels troca para estéreo. pcm são amostras brutas de 16 bits little-endian sem cabeçalho, então não dá para ouvir no navegador; escolha wav se quiser as mesmas amostras em um arquivo reproduzível.
Cobrança
Cobrado a cada 1.000 caracteres de text, contando espaços, pontuação e quebras de linha. A quantidade de caracteres é conhecida antes do início da tarefa, então o orçamento é a cobrança final. Requisições malsucedidas não são cobradas.
Conteúdo
A SpicyAPI não adiciona nenhum filtro de conteúdo. Em nossos testes, roteiros que outros serviços recusam foram lidos palavra por palavra, com as tags de som executadas como escritas e nada pulado.
A SpicyAPI não adiciona nenhum filtro de conteúdo: os roteiros são lidos como escritos, seja qual for o conteúdo. Você é responsável pelos roteiros que envia e pelo uso que faz do áudio resultante, inclusive por não apresentá-lo como falas 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": "minimax/speech-2.8-hd/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"emotion": "neutral",
"language": "auto",
"voice_id": "Calm_Woman",
"output_format": "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.










