Skip to main content
O SUNO nos permite criar personagens de voz personalizados a partir de qualquer arquivo de áudio, realizando a clonagem de voz para geração musical. Diferente da API Persona existente (que utiliza o audio_id gerado pelo Suno), esta API aceita uma audio_url publicamente acessível, ou seja, sua própria gravação de voz. Este documento explica como integrar a API de clonagem de voz.

​
Passo 1: Criar um Personagem de Voz

Esta API possui três parâmetros de entrada: audio_url (obrigatório), que deve ser uma URL de um arquivo de áudio em formato MP3 ou WAV acessível publicamente, contendo uma voz humana clara de uma única pessoa; name e description (opcionais), que são o nome e a descrição do personagem de voz.
Requisitos do arquivo de áudio
  • O formato do áudio deve ser WAV ou MP3
  • A duração do áudio deve estar entre 10~240 segundos, sendo recomendado o uso de material de voz limpa de 30~60 segundos
  • O áudio deve conter fala ou canto de uma única pessoa, clara e identificável
  • Evite ruído de fundo, acompanhamento, eco, reverb; músicas completas com acompanhamento geralmente não passam na verificação de voz
  • Não inclua múltiplos falantes ou várias vozes
  • Materiais com volume muito baixo, fala pouco clara ou ruído excessivo podem resultar em falha na clonagem ou resultado de baixa qualidade Limitações de uso
  • Os personagens de voz criados por upload de áudio são recursos privados
  • Este personagem de voz não suporta reutilização entre contas
  • Recomenda-se usar o personagem logo após a criação, pois o não uso por longos períodos pode resultar em expiração ou indisponibilidade
  • O name retornado é gerado automaticamente pelo sistema, por favor, use o persona_id retornado como referência
Se a chamada falhar, tente novamente A clonagem de voz é uma tarefa intensiva em computação, mesmo que o material esteja totalmente em conformidade, há uma certa probabilidade de falhas ocasionais, como o retorno voices_sound_different (verificação de voz não aprovada). Essas falhas não estão relacionadas à qualidade do áudio, e tentar novamente com o mesmo material geralmente resulta em sucesso. Recomenda-se implementar 1 a 2 tentativas automáticas em caso de falha. Solicitações falhadas não serão cobradas.
A URL https://cdn.acedata.cloud/suno_demo.mp3 é um material de exemplo que pode ser chamado diretamente (MP3, 41 segundos, voz limpa de uma única pessoa). Para um exemplo em formato WAV, você pode usar https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765 (WAV, 41 segundos, mono 44.1kHz).
O resultado será:
Pode-se observar que o campo persona_id em data é o ID do personagem de voz criado. O campo is_public sempre será false, pois os personagens de voz criados por upload de áudio são privados. Note que o name retornado é gerado automaticamente pelo sistema, e posteriormente, utilize o persona_id para referenciar esse personagem de voz.

​
Passo 2: Usar o Personagem de Voz para Gerar Música

Com o ID do personagem de voz, podemos usar a API de Geração de Áudios do Suno para gerar música. Defina action como generate e persona_id como o ID do personagem de voz retornado acima; a música gerada será cantada com a voz clonada.
Nota: A clonagem de voz suporta apenas modelos chirp-v4-5 e superiores (como chirp-v4-5, chirp-v5, chirp-v5-5), não suportando chirp-v4.
O resultado será:
Pode-se observar que a música gerada foi cantada com a voz clonada. O persona_id também pode ser utilizado em conjunto com a ação cover para regravar músicas existentes com a voz clonada.