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

# Documentation de l'API Suno MP3 URL

> Suno Music Generation API guide - Ace Data Cloud

L'API Suno MP3 URL génère un chemin pour une musique existante se terminant par `.mp3`, adapté aux scénarios où les anciens liens de téléchargement sont invalides, pour la lecture sur mobile ou pour récupérer à nouveau une URL audio publique.

Le paramètre requis `audio_id` est l'ID audio retourné par l'interface de génération audio de Suno. Chaque appel crée une tâche URL MP3 indépendante, sans modifier la tâche de génération de musique originale ni changer l'ID audio d'origine.

## Appel synchrone

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

En cas de succès, `data[0].file_url` est l'adresse audio jouable. L'interface essaiera d'abord de stocker à `https://cdn.acedata.cloud/suno/{audio_id}.mp3` ; si la persistance échoue, elle renverra l'adresse média originale actuellement disponible.

## Appel asynchrone

Lorsque le temps de traitement est long, vous pouvez passer `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"]
```

Ensuite, interrogez `export_task_id` via `/suno/tasks`. Vous pouvez également fournir `callback_url` pour recevoir le résultat final une fois la tâche terminée. La réponse synchrone, la requête de tâche et le rappel utilisent la même structure de données finale.

## Remarques

* `audio_id` doit provenir d'un audio Suno identifiable.
* Les tâches d'URL MP3 sont indépendantes des tâches de génération de musique d'origine.
* L'échec de la persistance ne bloquera pas le résultat, il reviendra à l'adresse média originale ; veuillez télécharger rapidement.
* Il est conseillé que le côté métier télécharge rapidement les résultats obtenus et les conserve selon sa propre stratégie de conservation des données.


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