Introdução
O Suno v6 Mini no SpicyAPI é uma tarefa de texto para música que devolve duas versões completas de uma música por requisição. A Suno o descreve como uma versão mais rápida e eficiente do v6, que facilita transformar uma ideia em música. Você envia uma descrição de estilo em prompt, opcionalmente a sua própria lyrics, e recebe dois MP3. Aqui ele custa o mesmo preço fixo do v6 e do v6 Wild.
Recursos e destaques
Ideia entra, música sai
Escreva uma frase e deixe lyrics vazio: com generate_lyrics ativado (o padrão), o modelo escreve as palavras e as canta. No nosso teste, ele escreveu cerca de três minutos e meio de letra e cantou cada linha em ordem.
O mesmo tratamento da letra
Traga as suas palavras e o v6 Mini as canta como foram escritas. A letra de 11 linhas que usamos nos três modelos voltou palavra por palavra e em ordem, com as tags [Verse] e [Chorus] em silêncio.
Um par de takes
Cada requisição devolve duas versões, que podem diferir na duração. O preço fixo cobre as duas, então um rascunho rápido custa o mesmo, por mais longa que a música fique.
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
Esboçar músicas rápido
Use-o como um caderno: digite o refrão, ouça, reescreva. Letras curtas dão músicas de cerca de um minuto e meio.
Estilos suaves, acústicos e lounge
Descrições de folk, indie e jazz com um punhado de instrumentos nomeados são o que geramos para os nossos exemplos, de uma música folk em dedilhado a um instrumental lounge esfumaçado.
Guia de prompt e dicas práticas
Mantenha a descrição curta e concreta
Cite o gênero, o andamento em bpm e dois ou três instrumentos, por exemplo “acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar”. Nomes de artistas reais são recusados.
Deixe escrever e depois assuma o controle
Comece por uma ideia e leia a letra que o modelo escolheu. Copie para lyrics as linhas de que gostar, edite e rode de novo para ouvi-las cantadas exatamente como você escreveu.
Saiba o que o filtro barra
A Suno recusa letras e descrições acima do nível Leve em segundos, sem cobrança. Letras de nível Leve e linguagem forte foram cantadas.
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-mini/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.
