Перейти к основному содержанию

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.

SUNO позволяет получать музыкальные файлы в формате wav. В этом документе описан метод интеграции соответствующего API. Основным входным параметром этого API является audio_id — официальный идентификатор песни; опционально поддерживается параметр callback_url для асинхронного обратного вызова. В данном примере в качестве audio_id используется значение 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)
Результат: 
{
  "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"
    }
  ]
}
Как видно, поле file_url в data содержит ссылку на wav-файл музыки, который доступен через публичный CDN.
О сохранении и сроке действия WAV-ссылок WAV-файлы на исходном CDN Suno (https://cdn1.suno.ai/{audio_id}.wav) хранятся всего несколько дней, после чего удаляются, и при попытке доступа возвращается ошибка 403. Чтобы избежать недоступности ссылки, данный API автоматически копирует исходный WAV-файл на собственный CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav) перед возвратом результата. Возвращаемый file_url — это стабильная ссылка на скопированный файл, которая не станет недействительной сразу после истечения срока действия исходного CDN. Срок действия скопированной ссылки составляет 30 дней; по истечении этого времени файл будет регулярно удалён. Рекомендуется как можно скорее скачать файл и сохранить его в собственном хранилище. В редких случаях при неудаче копирования ссылка будет возвращена на исходный URL, что соответствует прежнему поведению.