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"])
{
"id": "<string>",
"status": "<string>",
"progress": 123,
"cost": 123,
"created": 123,
"completed": 123,
"result": {
"music": [
{}
],
"instruments": [
{}
],
"files": [
{}
],
"videoUrl": "<string>",
"avg_bpm": 123
},
"error": {}
}음악 태스크 상태 조회
음악 태스크 상태 조회
Suno 음악 태스크의 상태와 결과 조회
GET
/
v1
/
music
/
tasks
/
{task_id}
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"])
{
"id": "<string>",
"status": "<string>",
"progress": 123,
"cost": 123,
"created": 123,
"completed": 123,
"result": {
"music": [
{}
],
"instruments": [
{}
],
"files": [
{}
],
"videoUrl": "<string>",
"avg_bpm": 123
},
"error": {}
}- 비동기 음악 태스크의 상태와 결과 조회
- 실시간 진행률 추적
- 완료 시 오디오·커버·영상 URL 획득(CDN 미러)
- 실패 태스크 자동 환불
Authorizations
string
필수
Bearer Token. API Key:API Key 관리 페이지
Path Parameters
string
필수
음악 생성 API가 반환한 태스크 ID(
tsk_aud_ 접두사)Response
string
태스크 ID
string
submitted / queued / in_progress / completed / failedinteger
진행률 0-100
number
실제 업스트림 비용(USD)
integer
생성 시각(Unix)
integer
완료 시각(Unix)
object
object
실패 시 오류(
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"])