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

> Suno Music Generation API guide - Ace Data Cloud

Suno MP3 URL API skapar en väg till ett spelbart ljud med slutet `.mp3` för befintlig musik, lämplig för scenarier där gamla nedladdningslänkar har slutat fungera, mobiluppspelning eller behovet av att återfå offentliga ljud-URL:er.

Obligatorisk parameter `audio_id` är ljud-ID:t som returneras av Suno ljudgenereringsgränssnittet. Varje anrop skapar en oberoende MP3 URL-uppgift, ändrar inte den ursprungliga musikgenereringsuppgiften och påverkar inte det ursprungliga ljud-ID:t.

## Synkront anrop

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

Vid framgång är `data[0].file_url` den spelbara ljudadressen. Gränssnittet kommer först att spara till `https://cdn.acedata.cloud/suno/{audio_id}.mp3`; om persistens misslyckas returneras den aktuella tillgängliga ursprungliga medieadressen.

## Asynkront anrop

Vid längre behandlingstid kan `async: true` anges:

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

Därefter kan du kontrollera `export_task_id` via `/suno/tasks`. Du kan också ange `callback_url` för att ta emot det slutliga resultatet när uppgiften är klar. Synkrona svar, uppgiftsfrågor och återkoppling använder samma slutdata-struktur.

## Viktiga punkter

* `audio_id` måste komma från ett identifierbart Suno-ljud.
* MP3 URL-uppgifter är oberoende av den ursprungliga musikgenereringsuppgiften.
* Persistensmisslyckande blockerar inte resultatet, utan återgår till den ursprungliga medieadressen; vänligen ladda ner i tid.
* Det rekommenderas att affärssidan laddar ner resultatet i tid och sparar enligt sin egen datalagringspolicy.


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