> ## 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 Integration Instructions for Custom Singer Style

> Suno Music Generation 集成指南 - XHuoAPI

SUNO позволяет нам установить стиль певца для уже сгенерированных песен, а затем на его основе проводить вторичное творчество. В этом документе объясняется, как интегрировать соответствующий API.

Этот API имеет только три входных параметра: во-первых, `audio_id`, который является ID песни, успешно сгенерированной официально, во-вторых, `name` и `description`, которые представляют собой название и описание стиля певца.

Здесь мы вводим `audio_id`, который равен `https://cdn.xhuoapi.ai/2qhzs3.png`, это можно использовать в качестве справки для [Suno Audios Generation API](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) для генерации пользовательских песен, в итоге можно получить `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"
}'
```

Результат будет следующим:

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

Как видно, поле `persona_id` в `data` является ID стиля певца, полученного после генерации.

Получив ID стиля певца, мы можем использовать [Suno Audios Generation API](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) для генерации пользовательских песен, например, передав `action` как `artist_consistency`, одновременно передав `audio_id` загруженного ID песни, также необходимо передать параметр `persona_id`, значение которого — это ID стиля певца, возвращенное выше, и тогда можно будет сгенерировать новую песню на основе указанного стиля певца.