Saltar para o conteúdo principal
POST
Referenciar faixa de origem: operações baseadas em músicas existentes não exigem memorizar nenhum id upstream, basta passar task_id (o nosso task_id da tarefa que gerou a faixa de origem) + audio_index (qual música dentro de music[] do resultado, baseado em 1, padrão 1).
custom não é obrigatório nem inferido para o extend — omita-o e a extensão funciona normalmente; se for passado, é encaminhado ao upstream como está. custom=true estende seguindo a letra de prompt; com custom=false ou omitido, você pode passar gpt_description (prompt de inspiração) para guiar a direção.

Authorizations

Authorization
string
obrigatório
Todos os endpoints exigem autenticação com Bearer TokenObter a API Key:Acesse a página de gerenciamento de API Key para obter sua API KeyAo usar, adicione ao cabeçalho da requisição:

Body

model
string
padrão:"suno"
Modelo de áudio. Atualmente passe suno (se não informado, o padrão é suno).
task_id
string
obrigatório
O nosso task_id da tarefa que gerou a faixa de origem. Se ausente ou se a origem não puder ser resolvida, um 400 é retornado no momento do envio.
audio_index
integer
padrão:"1"
Qual música dentro de data.music[] do resultado da tarefa de origem (baseado em 1; padrão 1; uma geração normalmente produz 2 músicas: índices 1 e 2).
continue_at
integer
obrigatório
A partir de qual segundo continuar.
version
string
padrão:"v5.5"
Versão de geração: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, afeta a qualidade do áudio e a cobrança; se não informado, o padrão é v5.5, e um valor inválido retorna 400 diretamente no momento do envio.
custom
boolean
Não é necessário passá-lo (não é exigido para o extend). true=estende seguindo a letra de prompt; false=extensão guiada por inspiração.
prompt
string
Letra da extensão. Tem efeito quando custom=true.
gpt_description
string
Prompt de inspiração. Tem efeito quando custom=false ou quando custom é omitido (guia a direção da extensão).
title
string
Título. Só tem efeito quando custom=true.
tags
string
Tags de estilo. Só tem efeito quando custom=true.
negative_tags
string
Tags de estilo a excluir. Só tem efeito quando custom=true.
vocal_gender
string
Gênero vocal: Male / Female. Funciona em ambos os modos.
style_weight
number
Peso do estilo, 0.001.00 (valores fora do intervalo retornam 400 diretamente no momento do envio). Só tem efeito quando custom=true.
weirdness_constraint
number
Criatividade, 0.001.00 (alias weirdness). Só tem efeito quando custom=true.
audio_weight
number
Peso do áudio, 0.001.00. Só tem efeito quando custom=true.
auto_lyrics
boolean
true=reescrever criativamente a letra fornecida. Só tem efeito quando custom=true.
persona_id
string
Id de estilo Persona. Só tem efeito quando custom=true.
Obter resultado: este endpoint é uma tarefa assíncrona. Após enviar, você recebe task_id; faça polling em GET /v1/music/tasks/{task_id} a intervalos de 3–5s, até que status seja completed ou failed (a geração de música normalmente leva 30–120s; durante a geração, status é pending e progress avança na fila 10 → pronto 50 → concluído 100). Ao concluir, pegue o audio_url estendido em data.result.music[]. Em caso de falha, data.error.message indica o motivo e a cota pré-reservada é automaticamente devolvida.

Response

code
integer
Código de status da resposta
data
array
Array de dados retornados