ToAPIsToAPIs
音楽タスク状態の取得

音楽タスク状態の取得

Suno 音楽タスクの状態と結果を照会

GET
/v1/music/tasks/{task_id}
  • 非同期音楽タスクの状態と結果を照会
  • リアルタイム進捗トラッキング
  • 完了時に音声・カバー・動画 URL を取得(CDN ミラー済み)
  • 失敗タスクは自動返金

すべての音楽タスクは非同期実行です。送信後は本エンドポイントでポーリングしてください。

Authorizations

Authorizationstringヘッダー必須

Bearer Token。API Key:API Key 管理ページ

Path Parameters

task_idstringパス必須

音楽生成 API が返したタスク ID(tsk_aud_ プレフィックス)

Response

idstring
タスク ID
statusstring
submitted / queued / in_progress / completed / failed
progressinteger
進捗 0-100
costnumber
実際の上流コスト(USD)
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:動画 URL
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"])