音楽タスク状態の取得
音楽タスク状態の取得
Suno 音楽タスクの状態と結果を照会
- 非同期音楽タスクの状態と結果を照会
- リアルタイム進捗トラッキング
- 完了時に音声・カバー・動画 URL を取得(CDN ミラー済み)
- 失敗タスクは自動返金
すべての音楽タスクは非同期実行です。送信後は本エンドポイントでポーリングしてください。
Authorizations
Authorizationstringヘッダー必須Bearer Token。API Key:API Key 管理ページ
Path Parameters
task_idstringパス必須音楽生成 API が返したタスク ID(tsk_aud_ プレフィックス)
Response
idstringタスク ID
statusstringsubmitted / queued / in_progress / completed / failedprogressinteger進捗 0-100
costnumber実際の上流コスト(USD)
createdinteger作成時刻(Unix)
completedinteger完了時刻(Unix)
resultobjectタスク結果。構造は操作により異なります:
result 構造
musicarrayaudio_url、image_url、title、tags、lyrics、duration を含むトラック列instrumentsarraymidi:トラック別 name/program/is_drum/notes[]filesarraydownload:マルチフォーマットのファイル URLvideoUrlstringgenerateMp4:動画 URLavg_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"])