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).
Este endpoint não possui dimensão de versão: não passe version — se passado, ele é descartado e não afeta a cobrança.
Pré-requisito: concat só pode juntar segmentos produzidos por extend (continuação). Se a origem não for um produto de extend (por ex. uma música completa gerada de uma só vez), a requisição é rejeitada no envio com um 400 e o upstream não é chamado.

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 de origem — deve ser um segmento produzido por extend (continuação) (veja o aviso acima). Se estiver ausente, não for um produto de extend, 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).
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 (normalmente leva 30–120s; durante a geração, status é pending e progress vai de fila 10 → pronto 50 → concluído 100). Ao concluir, pegue o audio_url da música completa 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