Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

A SUNO nos permite obter arquivos de música no formato wav. Este documento explica o método de integração da API relacionada. O principal parâmetro de entrada desta API é audio_id, que é o ID da música gerado oficialmente; opcionalmente, também suporta o endereço de callback assíncrono callback_url. Aqui, o audio_id que inserimos é 4e43116a-bf09-472c-8e1c-655eabf02682. 
import requests

url = "https://api.xhuoapi.ai/v1/suno/wav"

headers = {
    "accept": "application/json",
    "authorization": "Bearer aa287fa4cc54401087a9fab3f99630af",
    "content-type": "application/json"
}

payload = {
    "audio_id": "4e43116a-bf09-472c-8e1c-655eabf02682"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
O resultado é o seguinte: 
{
  "success": true,
  "task_id": "6a5a2099-d6d3-4930-9709-a30ac5dc7de5",
  "trace_id": "3fa70e81-6bb7-4ca8-b718-dd16a4eda7e8",
  "data": [
    {
      "file_url": "https://platform.cdn.xhuoapi.ai/suno/6a5a2099-d6d3-4930-9709-a30ac5dc7de5.wav"
    }
  ]
}
Pode-se observar que o campo file_url dentro de data é o arquivo de música no formato wav obtido, que é um endereço CDN acessível publicamente.
Sobre a persistência e validade do link WAV Os arquivos WAV no CDN upstream da Suno (https://cdn1.suno.ai/{audio_id}.wav) são mantidos apenas por alguns dias e depois são removidos, retornando 403 ao acessar. Para evitar que o link expire, esta API automaticamente transfere o arquivo WAV upstream para nosso próprio CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav) antes de retornar, e o file_url retornado é o endereço estável após a transferência, que não expirará imediatamente devido à expiração do CDN upstream. O link transferido tem validade de 30 dias; após 30 dias, o arquivo será limpo periodicamente. Recomenda-se baixar o arquivo o quanto antes e armazená-lo adequadamente em seu próprio armazenamento. Em casos raros de falha na transferência, o link original upstream será retornado, mantendo o comportamento histórico.