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

# get music

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

## Request

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

If the generation is complete, one songs will be returned. 

Note (2026-04): Producer is now powered by Google Lyria 3 Pro. Some legacy fields may be null for new generations (see field-level notes below). The new fields `wav_url`, `lyrics_id`, and `lyrics_timing_markers` are exposed when available.

## Path parameters

- `task_id` string, required

## Response `200`

- object
  - `code` integer, required: HTTP status code of the response
  - `data` object[], required: Array of generated music tracks
    - `clip_id` string: Unique identifier for the music clip
    - `title` string: Title of the generated music track
    - `sound` string, nullable: Sound style prompt used in generation. May be null for Lyria 3 Pro responses (the upstream does not echo the original prompt).
    - `lyrics` string, nullable: May be null for Lyria 3 Pro responses.
    - `image_url` string: URL to the cover art image
    - `audio_url` string: URL to the audio file (typically M4A format). For WAV format, see wav_url.
    - `video_url` unknown
    - `created_at` string: Timestamp when the track was created
    - `mv` string, nullable: Model version used for generation. May be null for Lyria 3 Pro responses (the upstream does not echo this back).
    - `seed` string, nullable: Random seed used for generation (for reproducibility). May be null for Lyria 3 Pro responses.
    - `duration` number, nullable: Length of the audio track in seconds. May be null for Lyria 3 Pro responses (the upstream does not return a duration value).
    - `state` string, nullable: Current state of the track (pending/running/succeeded)
    - `wav_url` string, nullable: URL to the WAV-format audio file. Available for Lyria 3 Pro responses
    - `lyrics_id` string, nullable: Identifier for the lyrics/synchronization metadata (Lyria 3 Pro only)
    - `lyrics_timing_markers` string, nullable: Word-level timing markers as [[word_index, time_seconds], ...] (Lyria 3 Pro only)
  - `message` string, required: Response message or error description

---

[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)