ToAPIsToAPIs
取得音樂任務狀態

取得音樂任務狀態

查詢 Suno 音樂任務的狀態和結果

GET
/v1/music/tasks/{task_id}
  • 查詢異步音樂任務的執行狀態和結果
  • 即時狀態更新和進度追蹤
  • 任務完成時取得音訊、封面、影片等媒體 URL(已鏡像本站 CDN)
  • 任務失敗自動退還費用

所有音樂任務都是異步執行的。提交任務後,請透過本接口輪詢任務狀態和結果。

Authorizations

Authorizationstring請求頭必填

使用 Bearer Token 認證,取得 API Key:API Key 管理頁面

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 等

instrumentsarray

midi 操作返回的分軌音符資料(name/program/is_drum/notes[])

filesarray

download 操作返回的多格式檔案 URL 列表

videoUrlstring

generateMp4 返回的影片位址

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"])