메인 콘텐츠로 건너뛰기

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로, 이는 공식에서 생성한 곡 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"
    }
  ]
}
보시다시피, data의 file_url 필드는 획득한 음악의 wav 형식 파일이며, 공개 접근 가능한 CDN 주소입니다.
WAV 링크의 지속성 및 유효 기간에 대하여 상위 Suno CDN에 있는 WAV 파일(https://cdn1.suno.ai/{audio_id}.wav)은 며칠간만 보관되며 이후 회수되어 접근 시 403 오류가 발생합니다. 링크 만료를 방지하기 위해, 본 API는 반환 전에 상위 WAV 파일을 자동으로 자체 CDN(https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav)에 전송 저장하며, 반환되는 file_url은 전송 저장된 안정적인 주소로 상위 CDN 만료로 인한 즉시 만료가 발생하지 않습니다. 전송 저장된 링크의 유효 기간은 30일이며, 30일이 지나면 해당 파일은 정기적으로 정리되므로 가능한 빨리 다운로드하여 자체 저장소에 안전하게 보관할 것을 권장합니다. 전송 저장 실패 시(매우 드물게 발생), 원본 상위 URL로 되돌아가며 동작은 기존과 동일합니다.