ToAPIsToAPIs
음악 태스크 상태 조회

음악 태스크 상태 조회

Suno 음악 태스크의 상태와 결과 조회

GET
/v1/music/tasks/{task_id}
  • 비동기 음악 태스크의 상태와 결과 조회
  • 실시간 진행률 추적
  • 완료 시 오디오·커버·영상 URL 획득(CDN 미러)
  • 실패 태스크 자동 환불

모든 음악 태스크는 비동기로 실행됩니다. 제출 후 본 엔드포인트로 폴링하세요.

Authorizations

Authorizationstring헤더필수

Bearer Token. API Key:API Key 관리 페이지

Path Parameters

task_idstring경로필수

음악 생성 API가 반환한 태스크 ID(tsk_aud_ 접두사)

Response

idstring
태스크 ID
statusstring
submitted / queued / in_progress / completed / failed
progressinteger
진행률 0-100
costnumber
실제 업스트림 비용(USD)
createdinteger
생성 시각(Unix)
completedinteger
완료 시각(Unix)
resultobject

태스크 결과. 구조는 작업에 따라 다릅니다:

result 구조
musicarray
audio_url, image_url, title, tags, lyrics, duration 포함 트랙 목록
instrumentsarray
midi:트랙별 name/program/is_drum/notes[]
filesarray
download:멀티 포맷 파일 URL
videoUrlstring
generateMp4:영상 URL
avg_bpmnumber
bpm:평균 BPM(max_bpm/min_bpm도 있음)
errorobject
실패 시 오류(code/message)

요청 예시

curl --request GET \
  --url https://toapis.com/v1/music/tasks/tsk_aud_01M3EXAMPLE \
  --header 'Authorization: Bearer <token>'
import time
import requests

task_id = "tsk_aud_01M3EXAMPLE"
while True:
    resp = requests.get(
        f"https://toapis.com/v1/music/tasks/{task_id}",
        headers={"Authorization": "Bearer <token>"}
    ).json()["data"]
    if resp["status"] in ("completed", "failed"):
        break
    time.sleep(5)
print(resp["result"])