获取音乐任务状态
获取音乐任务状态
查询 Suno 音乐任务的状态和结果
国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。文档示例中的 https://toapis.com 请替换为 https://toapis.cn。
- 查询异步音乐任务的执行状态和结果
- 实时状态更新和进度跟踪
- 任务完成时获取音频、封面、视频等媒体 URL（已镜像本站 CDN)
- 任务失败自动退还费用
所有音乐任务都是异步执行的。提交任务后，请通过本接口轮询任务状态和结果。
Authorizations
Authorizationstring请求头必填Path Parameters
task_idstring路径必填音乐生成接口返回的任务 ID(tsk_aud_ 前缀）
Response
idstring任务 ID
statusstring任务状态：submitted / queued / in_progress / completed / failed
progressinteger任务进度百分比（0-100)
costnumber实际上游成本（美元）
createdinteger创建时间戳（Unix)
completedinteger完成时间戳（Unix)
resultobject任务结果，结构随操作不同：
result 结构
musicarray曲目列表，每项含 audio_url、image_url、title、tags、lyrics、duration 等
instrumentsarraymidi 操作返回的分轨音符数据（name/program/is_drum/notes[])
filesarraydownload 操作返回的多格式文件 URL 列表
videoUrlstringgenerateMp4 返回的视频地址
avg_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"])