> ## 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 Wav API

> Suno Music Generation 集成指南 - XHuoAPI

SUNO дозволяє отримувати музичні файли у форматі wav. У цьому документі описано методи інтеграції відповідного API.

Основним вхідним параметром цього API є `audio_id`, який є офіційно згенерованим ідентифікатором пісні; додатково підтримується необов’язковий параметр `callback_url` для асинхронного зворотного виклику.

Тут ми вводимо `audio_id` зі значенням `4e43116a-bf09-472c-8e1c-655eabf02682`.

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/suno/wav"

headers = {
    "accept": "application/json",
    "authorization": "Bearer aa287fa4cc54401087a9fab3f99630af",
    "content-type": "application/json"
}

payload = {
    "audio_id": "4e43116a-bf09-472c-8e1c-655eabf02682"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

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

```json theme={null}
{
  "success": true,
  "task_id": "6a5a2099-d6d3-4930-9709-a30ac5dc7de5",
  "trace_id": "3fa70e81-6bb7-4ca8-b718-dd16a4eda7e8",
  "data": [
    {
      "file_url": "https://platform.cdn.xhuoapi.ai/suno/6a5a2099-d6d3-4930-9709-a30ac5dc7de5.wav"
    }
  ]
}
```

Як видно, поле `file_url` у `data` містить посилання на wav-файл музики, який є публічно доступною адресою CDN.

> **Щодо збереження та терміну дії посилання на WAV**
>
> WAV-файли на вихідному Suno CDN (`https://cdn1.suno.ai/{audio_id}.wav`) зберігаються лише кілька днів, після чого видаляються, і при спробі доступу повертається помилка 403.
> Щоб уникнути втрати доступу, цей API автоматично копіює WAV-файл з вихідного CDN на наш власний CDN (`https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav`) перед поверненням результату. Повернене поле `file_url` містить стабільне посилання на скопійований файл, яке не стане недійсним одразу після закінчення терміну дії вихідного CDN.
> **Термін дії скопійованого посилання становить 30 днів**, після чого файл буде періодично видалено. Рекомендується якнайшвидше завантажити файл і зберегти його у власному сховищі.
> У рідкісних випадках, якщо копіювання не вдається, посилання повертається на оригінальний вихідний URL, що відповідає попередній поведінці.