음악 태스크 상태 조회
음악 태스크 상태 조회
Suno 음악 태스크의 상태와 결과 조회
- 비동기 음악 태스크의 상태와 결과 조회
- 실시간 진행률 추적
- 완료 시 오디오·커버·영상 URL 획득(CDN 미러)
- 실패 태스크 자동 환불
모든 음악 태스크는 비동기로 실행됩니다. 제출 후 본 엔드포인트로 폴링하세요.
Authorizations
Authorizationstring헤더필수Bearer Token. API Key:API Key 관리 페이지
Path Parameters
task_idstring경로필수음악 생성 API가 반환한 태스크 ID(tsk_aud_ 접두사)
Response
idstring태스크 ID
statusstringsubmitted / queued / in_progress / completed / failedprogressinteger진행률 0-100
costnumber실제 업스트림 비용(USD)
createdinteger생성 시각(Unix)
completedinteger완료 시각(Unix)
resultobject태스크 결과. 구조는 작업에 따라 다릅니다:
result 구조
musicarrayaudio_url, image_url, title, tags, lyrics, duration 포함 트랙 목록instrumentsarraymidi:트랙별 name/program/is_drum/notes[]filesarraydownload:멀티 포맷 파일 URLvideoUrlstringgenerateMp4:영상 URLavg_bpmnumberbpm:평균 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"])