Saltar para o conteúdo principal
O SUNO permite que façamos upload de áudio de referência para criação secundária, este documento explica o método de integração da API relacionada. O upload comum requer apenas audio_url, que é um endereço de CDN de áudio acessível publicamente. O padrão de mode é standard, portanto, as chamadas existentes não precisam ser modificadas. Um upload comum bem-sucedido consome 0.06 Credits; uploads com falha não são cobrados. Aqui, o audio_url que inserimos é https://cdn.acedata.cloud/suno_demo.mp3, que é um endereço de CDN acessível publicamente.
O resultado é o seguinte:
Pode-se ver que data é sempre um objeto, e audio_id é o ID da música após o upload. Os resultados de análise, como lyric, style, duration, título e URLs de mídia, são campos opcionais, e os detalhes dependem do conteúdo retornado. Depois de obter o ID da música, é possível usar a API de Geração de Áudios do Suno para chamar operações que exigem audio_id, como upload_extend, upload_cover ou amostragem por intervalo. Se quiser criar novas músicas com base em 1 a 4 áudios de referência completos por meio do recurso de criação por inspiração Inspo, chame diretamente action=inspo e transmita a lista de URLs de áudio públicos originais; o serviço concluirá automaticamente o upload e a análise, sem a necessidade de o cliente montar os metadados de áudio.

Fazer upload da música original para cover com timbre privado

Ao fazer um cover usando uma voz privada criada com /suno/voices, transmita o persona_id dessa voz na solicitação de upload comum para associar a música original à voz:
Após o upload bem-sucedido, use o data.audio_id retornado para chamar /suno/audios, defina action: "upload_cover" e transmita o mesmo persona_id. Não continue usando o ID de áudio anterior que não foi associado a essa voz. persona_id oferece suporte apenas ao upload comum e não pode ser usado simultaneamente com mode: "enhanced". Não é necessário especificar adicionalmente vocal_gender; a preferência de gênero não pode substituir o ID da voz. A criação da voz, o upload da música original e o cover devem usar o mesmo canal de serviço.

Modo de upload aprimorado

audio_url é o endereço de entrada, que será enviado diretamente ao fluxo de processamento de áudio e não será previamente transferido pelo serviço de persistência de mídia do estado final. Certifique-se de que ele esteja acessível publicamente durante o processamento da tarefa.
Quando o upload comum não consegue processar um áudio que você possui ou está autorizado a usar, é possível definir mode como enhanced. Esse modo também deve fornecer um name de 1 a 100 caracteres e usar um audio_url HTTPS acessível publicamente. O upload aprimorado adota obrigatoriamente processamento assíncrono e geralmente requer 2 minutos ou mais. O processamento bem-sucedido consome 1.87 Credits; falhas no processamento não são cobradas.
A interface retornará imediatamente task_id e trace_id. Use a API de Tarefas do Suno para consultar a tarefa e, após o sucesso, leia o ID do áudio enviado em response.data.audio_id. Também é possível fornecer um callback_url HTTPS para receber o estado final. O audio_id obtido ao aprimorar o upload pode ser usado para Cover, Samples e Mashup. A extração de acompanhamento e MIDI, a separação de todas as faixas e a separação de voz/acompanhamento ainda podem estar sujeitas a restrições da conta à qual o áudio pertence; operações não listadas não têm garantia de suporte para uso entre contas. Quanto mais curto o áudio, normalmente maior a taxa de sucesso do processamento.