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

> Suno Music Generation API guide - Ace Data Cloud

L'API Suno MP3 URL genera un percorso per una musica esistente con un indirizzo riproducibile che termina con `.mp3`, adatto per scenari in cui i vecchi link di download non funzionano, per la riproduzione su dispositivi mobili o per la necessità di riottenere URL audio pubblici.

Il parametro obbligatorio `audio_id` è l'ID audio restituito dall'interfaccia di generazione audio di Suno. Ogni chiamata creerà un'attività MP3 URL indipendente, senza modificare l'attività di generazione musicale originale e senza cambiare l'ID audio originale.

## Chiamata Sincrona

```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"])
```

In caso di successo, `data[0].file_url` è l'indirizzo audio riproducibile. L'interfaccia tenterà prima di salvare su `https://cdn.acedata.cloud/suno/{audio_id}.mp3`; se il salvataggio permanente fallisce, restituirà l'attuale indirizzo media originale disponibile.

## Chiamata Asincrona

Se il tempo di elaborazione è lungo, è possibile passare `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"]
```

Successivamente, è possibile controllare `export_task_id` tramite `/suno/tasks`. È anche possibile fornire `callback_url` per ricevere il risultato finale al termine del compito. La risposta sincrona, la query del compito e il callback utilizzano la stessa struttura di dati finale.

## Note Importanti

* `audio_id` deve provenire da un audio Suno riconoscibile.
* Le attività MP3 URL sono indipendenti dalle attività di generazione musicale originali.
* Il fallimento del salvataggio permanente non bloccherà il risultato, tornando all'indirizzo media originale; si prega di scaricare tempestivamente.
* Si consiglia al lato business di scaricare tempestivamente i risultati e di conservarli secondo la propria strategia di conservazione dei dati.


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