Áudio
Generate Persona audio
Generate a persona/voice/style identity for reuse across tracks.
Categoria: Música · suno-generate-persona
Como usar & limites
- Cria uma persona reutilizável (identidade de voz/estilo) para reaproveitar entre faixas.
- Retorna um identificador de persona (texto), não áudio.
- prompt descreve gênero, humor e traços vocais da persona.
- Aplique o id resultante em geradores de música que aceitam persona_id.
Capacidades
O que este modelo suporta, direto do schema — sem preços, sem detalhes de infraestrutura.
| Capacidade | Valor |
|---|---|
music Música | Sim |
persona Persona de voz | Sim |
max_prompt_length Tamanho máx. do prompt | 5000 |
Parâmetros
Campos aceitos em params (ou de primeira classe, quando aplicável) para POST /generations.
| Nome | Rótulo | Tipo | Obrigatório | Padrão | Opções | Mín / Máx | Descrição |
|---|---|---|---|---|---|---|---|
style | Style / genre | text | Opcional | — | — | — | Estilo/gênero opcional que caracteriza a persona. |
prompt | Prompt | textarea | Obrigatório | — | — | — | Descrição da persona: gênero, humor, características vocais. |
Exemplo de requisição
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-generate-persona",
"prompt": "Voz feminina grave e melancólica, indie-folk intimista.",
"params": {
"style": "indie folk"
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "suno-generate-persona",
"prompt": "Voz feminina grave e melancólica, indie-folk intimista.",
"params": {
"style": "indie folk"
}
}),
});
const { data } = await res.json();
Exemplo de resposta
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "suno-generate-persona",
"type": "audio",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp3",
"type": "audio"
}
]
}
}
O custo real do job é retornado em credits_charged na resposta concluída — consulte GET /balance para o saldo da conta.
Erros comuns deste tipo de job:
insufficient_credits | Saldo insuficiente para cobrir o job. |
content_policy_violation | Prompt ou mídia recusados por política de conteúdo. |
generation_timeout | O job excedeu o tempo máximo de processamento. |
rate_limited | Limite de requisições por minuto excedido. |
invalid_input | Parâmetro obrigatório ausente ou fora do schema do modelo. |
generation_failed | Falha genérica no processamento do job. |