Перейти до основного вмісту

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-файли на вихідному Suno CDN (https://cdn1.suno.ai/{audio_id}.wav) зберігаються лише кілька днів, після чого видаляються, і при спробі доступу повертається помилка 403. Щоб уникнути втрати доступу, цей API автоматично копіює WAV-файл з вихідного CDN на наш власний CDN (https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav) перед поверненням результату. Повернене поле file_url містить стабільне посилання на скопійований файл, яке не стане недійсним одразу після закінчення терміну дії вихідного CDN. Термін дії скопійованого посилання становить 30 днів, після чого файл буде періодично видалено. Рекомендується якнайшвидше завантажити файл і зберегти його у власному сховищі. У рідкісних випадках, якщо копіювання не вдається, посилання повертається на оригінальний вихідний URL, що відповідає попередній поведінці.