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
必填
音樂生成接口返回的任務 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"])