ToAPIsToAPIs
Статус музыкальной задачи

Статус музыкальной задачи

Запрос статуса и результата задачи Suno

GET
/v1/music/tasks/{task_id}
  • Опрос статуса и результатов асинхронных музыкальных задач
  • Отслеживание прогресса в реальном времени
  • По завершении — аудио, обложки, видео URL(зеркалятся на CDN)
  • При сбое средства возвращаются автоматически

Все музыкальные задачи асинхронны. После отправки опрашивайте этот endpoint.

Authorizations

Authorizationstringзаголовокобязательно

Path Parameters

task_idstringпутьобязательно

ID задачи из API генерации(префикс tsk_aud_)

Response

idstring
ID задачи
statusstring
submitted / queued / in_progress / completed / failed
progressinteger
Прогресс 0-100
costnumber
Фактическая стоимость upstream(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"])