Download Suno API MP3 and WAV: URLs, Auth and Storage

Short answer: after a song is complete, call POST /api/music/download-url when you need a playback or transfer URL, or call POST /api/music/download-file to stream the file into your own storage. Both are free. Temporary media normally expires after about seven days, so copy important files into durable storage.

Choose the correct delivery endpoint

Get an MP3 URL

curl -X POST "https://www.suno-api.io/api/music/download-url" \
  -H "Authorization: Bearer $SUNO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id":"YOUR_SONG_ID","kind":"song"}'

{
  "code": 200,
  "data": {
    "song_id": "YOUR_SONG_ID",
    "kind": "song",
    "url": "https://media.example.com/assets/song.mp3",
    "nav_url": "https://media.example.com/assets/song.mp3?...attachment"
  }
}

url is suitable for playback and controlled transfer. nav_url includes an attachment disposition for direct browser download. Never add the API key to either media URL.

Stream a file with download-file

curl -X POST "https://www.suno-api.io/api/music/download-file" \
  -H "Authorization: Bearer $SUNO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id":"YOUR_SONG_ID","kind":"song"}' \
  -o song.mp3

The response is a file stream, not JSON. Write to a temporary path, validate the response and final file size, then rename it into durable storage. Do not expose a partially written file as a successful download.

Python streaming example

with requests.post(
    f"{BASE}/api/music/download-file",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"song_id": song_id, "kind": "song"},
    stream=True,
    timeout=(15, 180),
) as response:
    response.raise_for_status()
    with open("song.mp3.part", "wb") as fh:
        for chunk in response.iter_content(256 * 1024):
            if chunk:
                fh.write(chunk)

Media kinds

A durable-delivery workflow

1. Wait until the song is completed or playable.
2. Download the file immediately or request a media URL.
3. Copy it to your own object storage and save your own key.
4. Serve customers from your durable copy.
5. If the temporary URL returns 404 later, refresh it and retry the copy; do not regenerate the song.

FAQ

Do MP3 and WAV downloads cost extra?

Media delivery is free. WAV availability depends on whether the WAV resource has been prepared for that song.

Why did a media URL return 404?

The object may have expired or not been prepared. Refresh the URL and verify the requested kind.

When should I use download-url vs download-file?

Use download-url when a URL is useful. Use download-file when your server should receive the bytes directly. Lyrics only support the file endpoint.

Continue with the media download API, WAV API, and batch generation guide.

← Back to all articles