Saltar al contenido 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 nos permite crear personajes de voz personalizados a partir de cualquier archivo de audio, logrando la clonación de voz para la generación musical. A diferencia de la API Persona existente (que utiliza el audio_id generado por Suno), esta API acepta un audio_url accesible públicamente, es decir, tu propia grabación de voz. Este documento explica cómo integrar la API de clonación de voz.

​
Paso 1: Crear un personaje de voz

Esta API tiene tres parámetros de entrada: audio_url (obligatorio), que es la URL de un archivo de audio en formato MP3 o WAV accesible públicamente, que contenga voz clara de una sola persona; name y description (opcionales), que son el nombre y la descripción del personaje de voz. Requisitos del archivo de audio:
  • Formato: MP3 o WAV
  • Duración: al menos 10 segundos
  • Contenido: voz clara de una sola persona, minimizando ruido de fondo o 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": "Ejemplo de grabación de voz del usuario"
}'
El resultado es el siguiente: 
{
  "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
  }
}
Como se observa, el campo persona_id dentro de data es el ID del personaje de voz creado. El campo is_public siempre es false porque los personajes de voz creados mediante la subida de audio son privados.

​
Paso 2: Generar música usando el personaje de voz

Con el ID del personaje de voz, podemos usar la Suno Audios Generation API para generar música. Establece action a generate y persona_id al ID del personaje de voz obtenido arriba; la canción generada usará la voz clonada para la interpretación.
Nota: La clonación de voz solo es compatible con modelos chirp-v4-5 y superiores (como chirp-v4-5, chirp-v5, chirp-v5-5), no es compatible con 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": "Una canción cálida de synth-pop sobre noches en la ciudad",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
El resultado es el siguiente: 
{
  "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": "Una canción cálida de synth-pop sobre noches en la ciudad",
      "duration": 156.28
    }
  ]
}
Como se puede ver, la canción generada utiliza la voz clonada para la interpretación. El persona_id también puede usarse junto con la acción cover para versionar canciones existentes con la voz clonada.