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

# Instruções de Integração da API Suno MP3 URL

> Suno Music Generation API guide - Ace Data Cloud

A API Suno MP3 URL gera um caminho para um endereço reproduzível que termina em `.mp3` para músicas já existentes, adequada para cenários em que links de download antigos estão inativos, reprodução em dispositivos móveis ou necessidade de recuperar novamente URLs de áudio públicos.

O parâmetro obrigatório `audio_id` é o ID de áudio retornado pela interface de geração de áudio Suno. Cada chamada cria uma tarefa de URL MP3 independente, não modificando a tarefa de geração de música original e não alterando o ID de áudio original.

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

Em caso de sucesso, `data[0].file_url` é o endereço de áudio reproduzível. A interface prioriza a transferência para `https://cdn.acedata.cloud/suno/{audio_id}.mp3`; se a persistência falhar, retorna o endereço de mídia original atualmente disponível.

## Chamada Assíncrona

Quando o tempo de processamento é longo, pode-se passar `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"]
```

Em seguida, consulte `export_task_id` através de `/suno/tasks`. Também é possível fornecer `callback_url`, para receber o resultado final após a conclusão da tarefa. A resposta síncrona, consulta de tarefa e callback utilizam a mesma estrutura de dados final.

## Observações

* `audio_id` deve ser proveniente de um áudio Suno reconhecível.
* As tarefas de URL MP3 são independentes das tarefas de geração de música original.
* Falhas de persistência não bloquearão o resultado, retornando ao endereço de mídia original; faça o download prontamente.
* Recomenda-se que o lado do negócio faça o download e salve de acordo com sua estratégia de retenção de dados assim que receber o resultado.


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