> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno MP3 URL API інтеграція

> Suno Music Generation API guide - Ace Data Cloud

Suno MP3 URL API генерує шлях до відтворювальної адреси, що закінчується на `.mp3`, для вже існуючої музики, що підходить для випадків, коли старі посилання для завантаження не працюють, для відтворення на мобільних пристроях або коли потрібно повторно отримати публічну аудіо URL.

Обов'язковий параметр `audio_id` - це ID аудіо, що повертається інтерфейсом генерації аудіо Suno. Кожен виклик створює незалежне завдання MP3 URL, не змінюючи оригінальне завдання генерації музики і не змінюючи оригінальний ID аудіо.

## Синхронний виклик

```python theme={null}
import requests

response = requests.post(
    "https://api.acedata.cloud/suno/mp3",
    headers={
        "accept": "application/json",
        "authorization": "Bearer <YOUR_API_TOKEN>",
        "content-type": "application/json"
    },
    json={"audio_id": "ef1ec21e-1540-4eb6-8fa5-26cb8b90d28f"},
    timeout=240
)
response.raise_for_status()
result = response.json()
print(result["data"][0]["file_url"])
```

У разі успіху, `data[0].file_url` є адресою для відтворення аудіо. Інтерфейс спочатку намагатиметься зберегти за адресою `https://cdn.acedata.cloud/suno/{audio_id}.mp3`; якщо збереження не вдасться, повернеться поточна доступна оригінальна медіа-адреса.

## Асинхронний виклик

Коли час обробки є тривалим, можна передати `async: true`:

```python theme={null}
submission = requests.post(
    "https://api.acedata.cloud/suno/mp3",
    headers={"authorization": "Bearer <YOUR_API_TOKEN>"},
    json={
        "audio_id": "ef1ec21e-1540-4eb6-8fa5-26cb8b90d28f",
        "async": True
    }
).json()

export_task_id = submission["task_id"]
```

Потім через `/suno/tasks` можна запитати `export_task_id`. Також можна надати `callback_url`, щоб отримати остаточний результат після завершення завдання. Синхронна відповідь, запит завдання та зворотний виклик використовують однакову структуру даних.

## Зверніть увагу

* `audio_id` повинен походити з впізнаваного аудіо Suno.
* Завдання MP3 URL незалежні від оригінальних завдань генерації музики.
* Невдача збереження не заблокує результат, буде повернено до оригінальної медіа-адреси; будь ласка, завантажте вчасно.
* Рекомендується бізнес-стороні своєчасно завантажувати результати та зберігати відповідно до своєї стратегії збереження даних.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.