Introdução
Descreva toda a cena de áudio em um único prompt: quem fala, como, e as falas entre aspas, além de qualquer música, ambiente ou efeito sonoro. A tarefa devolve um arquivo de áudio de até cerca de dois minutos com tudo o que você descreveu, incluindo diálogo de mais de um falante: um MP3, a menos que você defina output_format. Para reutilizar uma voz, envie até três clipes de referência em reference_audio_urls e nomeie-os @Audio1 a @Audio3 no prompt, ou indique uma imagem de referência em image_url; speed, pitch e volume ajustam a interpretação. A SpicyAPI não aplica nenhum filtro de conteúdo: cada prompt é lido como escrito. Cada requisição custa o mesmo preço fixo.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Áudio |
| Campo obrigatório | prompt — de 1 a 2.000 caracteres |
| Campos opcionais |
|
| Resultado | Um arquivo de áudio de até cerca de dois minutos: MP3 por padrão, ou WAV, Ogg Opus, PCM |
| Falantes | Vários, descritos no prompt ou tirados de até três clipes de referência; sem lista de vozes |
| Quantidade cobrada | Um preço fixo por requisição |
| Retenção | O áudio gerado fica armazenado por 14 dias |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva a cena inteira em até 2.000 caracteres: cada falante e como ele soa, suas falas exatas entre aspas, e qualquer música, ambiente ou efeito sonoro. pelo menos 1 caracteres · no máximo 2000 caracteres |
reference_audio_urls | Não | Até três clipes MP3 ou WAV de referência: envie os arquivos ou informe URLs públicas. Cada clipe pode ter até 30 segundos e 10 MB. no máximo 3 itens |
image_url | Não | Imagem de referência opcional em torno da qual o áudio é criado: envie o arquivo ou informe uma URL pública e descreva no prompt o que a pessoa da imagem diz ou como a cena soa. pelo menos 1 caracteres |
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,5 a 2; 1 é o nível normal. Não altera o preço. |
output_format | Não | Formato do arquivo: mp3 (padrão), wav, opus (Ogg Opus) ou pcm, isto é, amostras estéreo brutas de 16 bits little-endian, intercaladas e sem cabeçalho, no |
sample_rate | Não | Taxa de amostragem do áudio em Hz: 8000, 16000, 24000, 32000, 44100, 48000. Padrão: 24000. |
Preços
$0.36 / requisição
Um preço fixo por requisição, um clipe de até cerca de dois minutos.
Casos de uso
Dramas de áudio com vários personagens
Descreva dois ou mais falantes e coloque suas falas entre aspas, e o modelo dá a cada um uma voz distinta no mesmo clipe — sem precisar de um modelo de voz separado para cada personagem.
Cenas com design de som
Um único prompt pode pedir diálogo, música de fundo, ambiente e efeitos sonoros ao mesmo tempo, de forma que uma única requisição devolva uma cena pronta em vez de apenas uma fala isolada.
Ficção de áudio sem censura
Os prompts são lidos como escritos, sem filtro de conteúdo. Em nossos testes, um monólogo em primeira pessoa, ficção narrada e uma cena com ambiente de chuva, todos escritos além do que outros serviços aceitam, voltaram com cada palavra falada.
Trilhas de voz para vídeo
Gere a cena aqui e depois passe o MP3 para um modelo de avatar falante ou de sincronização labial para que um rosto a interprete.
Guia de prompt e dicas práticas
Descreva os falantes
Diga quem está falando e como — um sussurro ofegante, um narrador caloroso — e coloque as palavras exatas entre aspas.
Adicione a paisagem sonora
Mencione qualquer música, ambiente ou efeito sonoro que você queira tocando junto com o diálogo: uma tempestade de chuva, um relógio fazendo tique-taque, uma trilha que vai crescendo.
Fique dentro de 2.000 caracteres
Um prompt cobre uma cena de até cerca de dois minutos; histórias mais longas precisam ser divididas em mais de uma requisição.
O que é retornado
Um arquivo de áudio por tarefa, de até cerca de dois minutos: um MP3, a menos que você mude output_format. O arquivo é copiado para o armazenamento da SpicyAPI e mantido por 14 dias.
Como escrever o prompt
O Seed Audio 1.0 recebe um único campo prompt (até 2.000 caracteres) que descreve a cena inteira:
- Quem fala e como — um sussurro, um narrador caloroso, uma fala gritada.
- As palavras exatas, entre aspas.
- Qualquer música, ambiente ou efeito sonoro que você queira junto com o diálogo.
Este modelo aceita mais de um falante no mesmo clipe: descreva cada personagem e suas falas, e ele dá a cada um uma voz distinta.
Áudio e imagem de referência
Não há lista de vozes. Para reaproveitar uma voz ou um som, envie até três clipes em reference_audio_urls e chame-os no prompt de @Audio1, @Audio2 e @Audio3, na ordem de envio, por exemplo “Com a voz de @Audio1, um homem diz …”. Ou informe uma imagem em image_url e descreva o que a pessoa da imagem diz ou como a cena soa; as duas entradas não se combinam. Use apenas vozes e imagens que você tem o direito de usar.
Interpretação e formato
speed (0,5–2), pitch (de -12 a 12 semitons) e volume (0,5–2) refinam a interpretação. output_format escolhe mp3 (padrão), wav, opus (Ogg Opus) ou pcm, e sample_rate vai de 8000 a 48000 Hz. pcm são amostras estéreo brutas de 16 bits little-endian sem cabeçalho, então não dá para ouvir no navegador; escolha wav para receber as mesmas amostras em um arquivo reproduzível. Nada disso altera o preço.
Cobrança
Um preço fixo por requisição, seja qual for o tamanho do prompt. Requisições que falharem não são cobradas.
Conteúdo
A SpicyAPI não adiciona nenhum filtro de conteúdo. Em nossos testes, três prompts que outros serviços recusam — um monólogo em primeira pessoa, ficção narrada e uma cena com ambiente de chuva — voltaram todos com cada palavra falada.
A SpicyAPI não adiciona nenhum filtro de conteúdo: os prompts são lidos como escritos, seja qual for o conteúdo. Você é responsável pelas cenas que descreve 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": "bytedance/seed-audio-1.0/text-to-audio",
"input": {
"output_format": "mp3",
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 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.
