---
title: "get music"
method: GET
path: "/api/v1/sonic/task/{task_id}"
tags: ["sonic"]
---

# get music

`GET /api/v1/sonic/task/{task_id}`

## Request

- Base URL: `https://api.musicapi.ai`
- URL: `https://api.musicapi.ai/api/v1/sonic/task/{task_id}`
- Auth: HTTP bearer

Use the obtained task ID to poll song data. Recommended polling interval: 15s-25s.

## Supported Task Types

| Task Type | Description | Response Format |
|-----------|-------------|----------------|
| create_music | Standard music creation | Array of songs |
| extend_music | Extend existing song | Array of songs |
| cover_music | Create cover version | Array of songs |
| upload-extend | Upload + Extend | Array of songs, or paired objects if auto_concat |
| upload-cover | Upload + Cover | Array of songs |
| concat_music | Concatenate songs | Array of songs |

## Response Format

- **Standard tasks**: `data` is an array of song objects
- **Tasks with `auto_concat: true`**: `data` is an array of paired objects `[{extended, full}, ...]`

For detailed auto_concat response examples, see:
- [upload-extend-music](upload-extend-music)
- [upload-cover-music](upload-cover-music)

## State Values

- `pending` - Task queued
- `running` - Processing
- `succeeded` - Completed successfully
- `failed` - Task failed

## Path parameters

- `task_id` string, required

## Response `200`

Success

- object
  - `code` integer, required: Response code (200 for success)
  - `data` object[], required: Array of song objects. For auto_concat tasks, each item contains {extended, full} pair.
    - `clip_id` string: Unique identifier for the song clip
    - `state` string: Task state: pending, running, succeeded, failed
    - `title` string: Song title
    - `tags` string: Music style tags
    - `lyrics` string: Song lyrics
    - `image_url` string: Cover image URL
    - `audio_url` string: Audio file URL (MP3)
    - `video_url` string: Video file URL (MP4)
    - `created_at` string: Creation timestamp (ISO 8601)
    - `mv` string: Model version used
    - `gpt_description_prompt` string: AI description prompt (if used)
    - `duration` integer: Song duration in seconds
  - `message` string, required: Response message

---

[API](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api.md) - [All operations](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musicapi/apis/musicapi-docs-suno-style-ai-music-generation-api/revisions/f94a2c7ed4a1?raw)