Introdução
O Suno v6 no SpicyAPI é uma tarefa de texto para música que devolve duas versões completas de uma música por requisição, cada uma um MP3 inteiro com voz e base. Você descreve o estilo em prompt e, se tiver, coloca as palavras a cantar em lyrics. Segundo a Suno, o v6 é o seu modelo confiável e preciso, e nos nossos testes ele cantou uma letra palavra por palavra, em ordem. Um preço fixo cobre toda a requisição.
Recursos e destaques
Duas takes sempre
Cada requisição devolve duas versões completas da música. Elas não são trechos uma da outra: podem diferir no arranjo e na duração, para você ficar com a que gostar. O preço fixo cobre as duas.
Sua letra, cantada como foi escrita
Uma letra de 11 linhas voltou cantada linha por linha, na ordem em que a escrevemos. Tags de seção como [Verse] e [Chorus] moldaram a estrutura sem serem cantadas, e o refrão não se repetiu a menos que a letra o repetisse.
Três formas de lidar com a letra
Traga a sua própria letra, deixe o modelo escrevê-la a partir de prompt (generate_lyrics vem ativado por padrão) ou ative instrumental para não ter voz. Controles de ajuste fino como title, vocal_gender, style_weight, weirdness, variety e personas valem quando você traz a sua letra ou opta pelo instrumental.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | A descrição de estilo. Com letra própria ou com instrumental ativado, é só o estilo: gênero, andamento, instrumentos, voz, clima, até 1.000 caracteres. pelo menos 1 caracteres · no máximo 3000 caracteres |
lyrics | Não | As palavras a cantar, até 5.000 caracteres, uma linha por linha. pelo menos 1 caracteres · no máximo 5000 caracteres |
generate_lyrics | Não | Ativado por padrão: quando lyrics está vazio e instrumental está desativado, o modelo escreve a letra a partir de prompt. A letra que você envia nunca é reescrita. Valor padrão: |
instrumental | Não | Ative para uma faixa sem voz. Aí prompt descreve o estilo (até 1.000 caracteres) e lyrics não é necessário. Valor padrão: |
title | Não | Nome da música, até 80 caracteres. Vale com letra própria ou com instrumental ativado; com letra gerada, o modelo escolhe o título. pelo menos 1 caracteres · no máximo 80 caracteres |
negative_prompt | Não | Estilos, sons ou climas a deixar de fora da música, como uma lista curta separada por vírgulas, por exemplo “harsh distortion, spoken word”. Opcional. pelo menos 1 caracteres · no máximo 500 caracteres |
vocal_gender | Não | Inclina a voz principal para feminina ou masculina. É uma preferência, não uma garantia, e não testamos com que frequência ela se cumpre. |
style_weight | Não | Com que rigor a música segue a sua descrição de estilo, de 0 a 1 em passos de 0,01. |
weirdness | Não | O quanto a música pode fugir do esperado, de 0 (convencional) a 1 (ousado), em passos de 0,01. Vale apenas com letra própria ou com instrumental ativado. |
audio_weight | Não | O quanto o áudio de entrada influencia o resultado, de 0 a 1 em passos de 0,01. A Suno não oferece suporte a isso em músicas sem voz. |
variety | Não | O quanto o modelo varia o seu prompt de estilo, como um número inteiro de 0 (desligado: suas tags de estilo são usadas exatamente como você as escreveu) a 4 (máximo). Padrão 1. |
persona_id | Não | O ID de uma persona ou voz Suno salva que canta ou toca a música. Opcional. pelo menos 1 caracteres · no máximo 200 caracteres |
persona_model | Não | Diz ao modelo o que é |
image_urls | Não | Até 5 imagens de clima (JPEG, PNG, WebP ou BMP, cada uma com até 10 MB) nas quais o modelo se baseia para o jeito da música. no máximo 5 itens |
reference_video_urls | Não | Um vídeo de referência (MP4, MOV ou WebM, até 100 MB e 241 segundos) em torno do qual a música é construída, por exemplo para musicá-lo. no máximo 1 itens |
reference_audio_urls | Não | Um arquivo de áudio de referência (de 6 segundos a 30 minutos, até 500 MB) que inspira a música. no máximo 1 itens |
Preços
$0.072 / requisição
Um preço fixo por requisição, cobrindo as duas versões da música, qualquer que seja a duração.
Casos de uso
Músicas que você já escreveu
Poemas, brindes, jingles e canções que contam histórias: mantenha o texto, escolha o gênero e a voz e compare duas versões. As músicas duraram de cerca de um minuto e meio, com uma letra curta, a mais de dois minutos, com uma letra completa.
Música que acompanha uma imagem ou um vídeo
Com letra gerada, você pode enviar até 5 imagens de clima, um vídeo de referência ou um áudio de referência, e o modelo escreve uma música em torno deles. Para uma trilha sem palavras, ative instrumental.
Guia de prompt e dicas práticas
Descreva o som, não o artista
Escreva o gênero, o andamento em bpm, dois ou três instrumentos e o tipo de voz: “soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano”. Prompts que citam artistas reais são recusados, então descreva o som.
Marque as seções
Coloque [Intro], [Verse], [Chorus], [Bridge] e [Outro] em linhas próprias e repita o texto do refrão onde quiser que ele volte. Mais linhas dão uma música mais longa; não existe configuração de duração.
Saiba o que o filtro barra
O Suno recusa em segundos as letras e descrições mais fortes e não as cobra. Letras mais suaves e linguagem forte são cantadas, então mantenha o texto desse lado da linha.
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": "suno/v6/text-to-audio",
"input": {
"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.
