Статус музыкальной задачи
Статус музыкальной задачи
Запрос статуса и результата задачи Suno
- Опрос статуса и результатов асинхронных музыкальных задач
- Отслеживание прогресса в реальном времени
- По завершении — аудио, обложки, видео URL(зеркалятся на CDN)
- При сбое средства возвращаются автоматически
Все музыкальные задачи асинхронны. После отправки опрашивайте этот endpoint.
Authorizations
AuthorizationstringзаголовокобязательноBearer Token. API Key:страница управления
Path Parameters
task_idstringпутьобязательноID задачи из API генерации(префикс tsk_aud_)
Response
idstringID задачи
statusstringsubmitted / queued / in_progress / completed / failedprogressintegerПрогресс 0-100
costnumberФактическая стоимость upstream(USD)
createdintegerСоздано(Unix)
completedintegerЗавершено(Unix)
resultobjectРезультат задачи; структура зависит от операции:
структура result
musicarrayТреки с
audio_url, image_url, title, tags, lyrics, durationinstrumentsarraymidi: по дорожкам name/program/is_drum/notes[]filesarraydownload: URL файлов разных форматовvideoUrlstringgenerateMp4: URL видеоavg_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"])