Instruções de integração da API de clonagem de voz do Suno

​

Etapa 1: criar um personagem de voz

Requisitos do arquivo de áudio

• O formato de áudio deve ser WAV ou MP3
• A duração do áudio deve estar entre 10~240 segundos; recomenda-se usar material de voz seca, limpa e de uma única pessoa, de 30~60 segundos
• O áudio deve conter fala ou canto claro e identificável de uma única pessoa
• Certifique-se de evitar ruído de fundo, acompanhamento, eco e reverberação; músicas completas com acompanhamento geralmente não passam na validação de impressão vocal
• Não inclua vários locutores ou múltiplas vozes
• Materiais com volume muito baixo, fala pouco clara ou ruído excessivo podem resultar em falha na clonagem ou qualidade de geração inferior Explicação das restrições de uso
• Os personagens de voz criados por meio do envio de áudio são recursos privados
• Este personagem de voz não oferece suporte à reutilização entre contas
• Recomenda-se usá-lo o mais rápido possível após a criação bem-sucedida; a falta de uso por muito tempo pode resultar em expiração ou indisponibilidade
• O name retornado é gerado automaticamente pelo sistema; use o persona_id retornado como referência

Em caso de falha na chamada, tente novamente primeiro A clonagem de voz é uma tarefa intensiva em recursos computacionais; mesmo que o material esteja totalmente em conformidade, há uma certa probabilidade de falhas ocasionais, com retornos comuns como voices_sound_different (a validação de impressão vocal não foi aprovada), entre outros. Esse tipo de falha não está relacionado à qualidade do áudio; normalmente, tentar novamente usando o mesmo material é suficiente para obter sucesso, recomenda-se implementar de 1 a 2 tentativas automáticas para resultados com falha durante a integração. Solicitações com falha não serão cobradas.

curl -X POST 'https://api.acedata.cloud/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.acedata.cloud/suno_demo.mp3",
  "name": "My Voice",
  "description": "单人清晰人声示例"
}'

O https://cdn.acedata.cloud/suno_demo.mp3 acima é um material de exemplo que pode ser chamado diretamente (MP3, 41 segundos, voz seca de uma única pessoa). Se precisar de um exemplo no formato WAV, você pode usar https://cdn.acedata.cloud/uploads/82d23b97-ec1c-4b41-91b8-989fc51f8765 (WAV, 41 segundos, mono 44,1 kHz).

{
  "success": true,
  "task_id": "0fa609a6-c8d9-4bb5-8574-e4c93bb55d02",
  "data": {
    "persona_id": "1ab79a71-a229-4350-8f02-402ff02eac16",
    "name": "VOICE_20260803037676",
    "is_public": false
  }
}

​

Etapa 2: usar o personagem de voz para gerar música

Observação: a clonagem de voz é compatível apenas com modelos chirp-v4-5 e superiores (como chirp-v4-5, chirp-v5, chirp-v5-5) e não é compatível com chirp-v4.

curl -X POST 'https://api.acedata.cloud/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": "1ab79a71-a229-4350-8f02-402ff02eac16"
}'

{
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}

{
  "action": "upload_cover",
  "model": "chirp-v6",
  "audio_id": "<与该声音关联上传后返回的 audio_id>",
  "persona_id": "<声音创建接口返回的 persona_id>",
  "custom": true,
  "instrumental": false,
  "lyric": "[Verse]\n填写要演唱的歌词",
  "async": true
}