> ## 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.

# Producer завантаження референсного аудіо API інтеграційна документація

> Producer Music Generation 集成指南 - XHuoAPI

Producer дозволяє нам завантажувати референсне аудіо для вторинного творчості, цей документ пояснює методи інтеграції відповідного API.

Цей API має лише один вхідний параметр, а саме `audio_url`, який є відкритою CDN адресою, що підтримує суфікс mp3.

Тут ми вводимо `audio_url` як `https://cdn.xhuoapi.ai/suno_demo.mp3`, це відкрита CDN адреса.

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/producer/upload' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.xhuoapi.ai/suno_demo.mp3"
}'
```

Результат виглядає так:

```
{
  "success": true,
  "task_id": "23e7d4ec-d1a8-429f-87d8-9f53fc3b6666",
  "data": {
    "audio_id": "d906da31-87cb-42f5-98df-2fc4969923b1",
    "lyric": "[Mandopop, Acoustic Pop]\n[М'які жіночі вокали, яскраві та веселощі]\n\n[Куплет 1]\nСонце світить на березі\nХвилі сміються яскраво\nТи і я на пляжі\nГодинник зупинився\nМорозиво тане\nРука в руці йдемо гуляти\nВітерець ніжно дме\nСерце не перестає битися\n\n[Приспів]\nЛіто, літо\nЧас зупинився в цей день\nСміх лунає\nБлакитне небо поруч",
    "audio_url": "https://storage.googleapis.com/corpusant-app-public/producer/raw/d906da31-87cb-42f5-98df-2fc4969923b1.mp3"
  }
}
```

Можна побачити, що поле `audio_id` в `data` є ID пісні після завантаження.

Отримавши ID пісні, ми можемо використовувати [Producer Audios Generation API](https://api.xhuoapi.ai/documents/producer-audios-integration) для генерації кастомізованих пісень, наприклад, передавши `action` як `upload_extend`, а `audio_id` як повернений ID пісні, ми можемо створити нову пісню на основі референсного аудіо.