> ## 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 API de integración de estilo de cantante personalizado

> Suno Music Generation 集成指南 - XHuoAPI

SUNO nos permite establecer el estilo de cantante para las canciones que ya han sido generadas y luego realizar una segunda creación basada en ello. Este documento explica cómo integrar la API relacionada.

Esta API solo tiene tres parámetros de entrada, primero `audio_id`, que es un ID de canción que ya ha sido generado exitosamente por la oficial, y luego `name` y `description`, que son un nombre y una descripción del estilo de cantante.

Aquí, el `audio_id` que ingresamos es `https://cdn.xhuoapi.ai/2qhzs3.png`, este se puede consultar en [Suno Audios Generation API](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) para generar canciones personalizadas, y al final se puede obtener el `audio_id`.

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/suno/persona' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "test",
  "audio_id": "81745564-60e7-4ad4-85a9-6f42f0f4f3b3",
  "description": "test"
}'
```

El resultado es el siguiente:

```
{
  "success": true,
  "task_id": "8e808558-f056-456f-91d6-b97fd94eb3be",
  "data": {
    "persona_id": "dae4ae5d-2b51-4af1-b286-1a4473ef4dba"
  }
}
```

Como se puede ver, el campo `persona_id` de `data` es el ID del estilo de cantante generado.

Una vez que tenemos el ID del estilo de cantante, podemos usar la [Suno Audios Generation API](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) para generar canciones personalizadas, por ejemplo, pasando `action` como `artist_consistency`, mientras que `audio_id` se pasa como el ID de la canción subida, también necesitamos subir el parámetro `persona_id`, cuyo valor es el ID del estilo de cantante devuelto anteriormente, y así se puede generar una nueva canción basada en el estilo de cantante de referencia.
