Check Music Status (Feed API)

Fetch the status and results of a music generation or extension task.

Endpoint Overview

GET/api/v1/audio/music/feed?workId={workId}

After starting a generation task, use this endpoint to poll for its status.

Generation has 3 stages:

Text Stage: status="text" - Lyrics and metadata generated
First Audio Stage: status="first" - First audio segment generated successfully
Complete Stage: Both audio segments finished

Poll this endpoint every 5-10 seconds until generation completes or fails.

Note: You can also use the generic GET /api/v1/tasks/{task_id} endpoint for polling.

Body ParametersJSON

workId:string

The unique ID of the generation task, received from a POST /api/v1/audio/music request.

bash

1	curl -X GET "https://apiin.one/api/v1/audio/music/feed?workId=gen123abc456def789ksv" \
2	-H "Authorization: Bearer aio_your_api_key_here"

Response when the task is fully completed.

json

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"type": "SUCCESS",
6	"request_body": {
7	"prompt": "...",
8	"title": "Summer Dreams",
9	"tags": "pop",
10	"make_instrumental": false,
11	"model": "suno-v4-5"
12	},
13	"response_data": [
14	{
15	"id": "song_abc123",
16	"audio_url": "https://audiopipe.suno.ai/?item_id=song_abc123",
17	"image_url": "https://cdn2.suno.ai/image_abc123.jpeg",
18	"status": "complete",
19	"title": "Summer Dreams",
20	"duration": 186,
21	"model_name": "suno-v4-5",
22	"extra_message": "All generated successfully.",
23	"fail_message": "",
24	"error_message": ""
25	},
26	{
27	"id": "song_def456",
28	"audio_url": "https://audiopipe.suno.ai/?item_id=song_def456",
29	"image_url": "https://cdn2.suno.ai/image_def456.jpeg",
30	"status": "complete",
31	"title": "Summer Dreams",
32	"duration": 210,
33	"model_name": "suno-v4-5",
34	"extra_message": "All generated successfully.",
35	"fail_message": "",
36	"error_message": ""
37	}
38	],
39	"created_at": "2026-02-24T12:00:31Z"
40	}
41	}

Body ParametersJSON

404:optional not_found

Task not found or expired.

401:optional authentication_error

Invalid or missing API key.