Retrieve the list of music tracks
June 25, 2026 (November 16, 2026)
Table of contents
Retrieve the list of music tracks, this will include those currently being generated or queued. Check the audio_status_name field for the status and the field audio_status_final to determine if the provided status is the final status.
The API internally uses the field audio_status to calculate values for audio_status_name and audio_status_final. See below for the known statuses map:
| audio_status | audio_status_name | audio_status_final |
|---|---|---|
| 1 | COMPLETED | true |
| 5 | QUEUED | false |
| 8 | FAILED | true |
| 10 | GENERATING | false |
https://api.useapi.net/v2/pixverse/music/?…
Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
API tokenis required, see Setup useapi.net for details.
Query Parameters
-
emailis optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required. -
limitis optional, specify the number of tracks to return. Default 50. -
offsetis optional, specify the offset from where to start.
Responses
-
{ "data": [ { "audio_id": "user:<userid>-pixverse:<email>-music:11223344", "asset_id": 11223344, "audio_status": 1, "status": "finish", "create_mode": "music", "provider": "minimax", "model": "music-2.6", "prompt": "<prompt>", "auto_lyrics": true, "url": "https://media.pixverse.ai/pixverse/audio/music/11223344.mp3", "name": "PixVerse_Music_11223344.mp3", "duration": 202, "credits": 40, "created_at": "2026-06-23T12:34:56Z", "updated_at": "2026-06-23T12:38:18Z", "audio_status_name": "COMPLETED", "audio_status_final": true } ], "next_offset": 50, "has_more": false } -
{ "error": "<Error message>", "code": 400 } -
{ "error": "Unauthorized", "code": 401 }
This endpoint returns music tracks only (create_mode: music). Text-to-speech audio is listed separately by GET speech.
Model
A page of music tracks in data, each with its status, prompt, model and audio url, plus next_offset and has_more.
The list of music tracks, field by field
{ // TypeScript, all fields are optional
data: {
audio_id: string
asset_id: number
audio_status: number
status: string
create_mode: string
provider: string
model: string
prompt: string
auto_lyrics: boolean
url: string
name: string
duration: number
credits: number
created_at: string
updated_at: string
// added
audio_status_name: string
audio_status_final: boolean
}[]
next_offset: number
has_more: boolean
}
Examples
-
curl "https://api.useapi.net/v2/pixverse/music/?email=email" \ -H "Accept: application/json" \ -H "Authorization: Bearer …" -
const token = "API token"; const email= "Previously configured account email"; const apiUrl = `https://api.useapi.net/v2/pixverse/music/?email=${email}`; const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}`, }, }); const result = await response.json(); console.log("response", {response, result}); -
import requests token = "API token" email= "Previously configured account email" apiUrl = f"https://api.useapi.net/v2/pixverse/music/?email={email}" headers = { "Content-Type": "application/json", "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers) print(response, response.json())