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": {}
}国内用户请注意： 中国大陆用户请使用
https://toapis.cn 作为接口地址（Base URL）。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。- 查询异步音乐任务的执行状态和结果
- 实时状态更新和进度跟踪
- 任务完成时获取音频、封面、视频等媒体 URL（已镜像本站 CDN)
- 任务失败自动退还费用
Authorizations
string
必填
Path Parameters
string
必填
音乐生成接口返回的任务 ID(
tsk_aud_ 前缀）Response
string
任务 ID
string
任务状态：
submitted / queued / in_progress / completed / failedinteger
任务进度百分比（0-100)
number
实际上游成本（美元）
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"])