> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 음악 태스크 상태 조회

> Suno 음악 태스크의 상태와 결과 조회

* 비동기 음악 태스크의 상태와 결과 조회
* 실시간 진행률 추적
* 완료 시 오디오·커버·영상 URL 획득(CDN 미러)
* 실패 태스크 자동 환불

모든 음악 태스크는 비동기로 실행됩니다. 제출 후 본 엔드포인트로 폴링하세요.

## Authorizations

**Authorization** `string` *required*

Bearer Token. API Key:[API Key 관리 페이지](https://toapis.com/console/token)

## Path Parameters

**task\_id** `string` *required*

음악 생성 API가 반환한 태스크 ID(`tsk_aud_` 접두사)

## Response

**id** `string`

태스크 ID

**status** `string`

`submitted` / `queued` / `in_progress` / `completed` / `failed`

**progress** `integer`

진행률 0-100

**cost** `number`

실제 업스트림 비용(USD)

**created** `integer`

생성 시각(Unix)

**completed** `integer`

완료 시각(Unix)

**result** `object`

태스크 결과. 구조는 작업에 따라 다릅니다:

**result 구조**

**music** `array`

`audio_url`, `image_url`, `title`, `tags`, `lyrics`, `duration` 포함 트랙 목록

**instruments** `array`

`midi`:트랙별 `name`/`program`/`is_drum`/`notes[]`

**files** `array`

`download`:멀티 포맷 파일 URL

**videoUrl** `string`

`generateMp4`:영상 URL

**avg\_bpm** `number`

`bpm`:평균 BPM(`max_bpm`/`min_bpm`도 있음)

**error** `object`

실패 시 오류(`code`/`message`)

```bash cURL theme={null}
curl --request GET \
  --url https://toapis.com/v1/music/tasks/tsk_aud_01M3EXAMPLE \
  --header 'Authorization: Bearer <token>'
```

```python Python theme={null}
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"])
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.