Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Passo 1: Criar Personagem de Voz

Esta API possui três parâmetros de entrada: audio_url (obrigatório), que deve ser uma URL pública de um arquivo de áudio MP3 ou WAV contendo voz 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:
  • Formato: MP3 ou WAV
  • Duração: no mínimo 10 segundos
  • Conteúdo: voz clara de uma única pessoa, com o mínimo possível de ruído de fundo ou música
curl -X POST 'https://api.xhuoapi.ai/v1/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "Exemplo de gravação vocal do usuário"
}'
O resultado será: 
{
  "success": true,
  "task_id": "b9150e51-d87c-4556-a55e-100947a63bdf",
  "data": {
    "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b",
    "name": "RU User Voice Test",
    "is_public": false
  }
}
Note que o campo persona_id dentro de data é o ID do personagem de voz criado. O campo is_public é sempre false, pois personagens criados via upload de áudio são privados.

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

Com o ID do personagem de voz, podemos usar a Suno Audios Generation API para gerar música. Defina action como generate e persona_id como o ID retornado acima; a música gerada será cantada com a voz clonada.
Atenção: 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. 
curl -X POST 'https://api.xhuoapi.ai/v1/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "A warm synth-pop song about city nights",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
O resultado será: 
{
  "success": true,
  "task_id": "53d8a334-a972-43c5-895e-60c4454e88d5",
  "data": [
    {
      "id": "16463960-077c-4700-bbb3-3c7897b943d3",
      "title": "Soft Neon on My Skin",
      "audio_url": "https://cdn1.suno.ai/16463960-077c-4700-bbb3-3c7897b943d3.mp3",
      "image_url": "https://cdn2.suno.ai/image_16463960-077c-4700-bbb3-3c7897b943d3.jpeg",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}
Como pode ser visto, a música gerada utiliza a voz clonada para cantar. O persona_id também pode ser usado com a ação cover para regravar músicas existentes com a voz clonada.