Suno API Reference

Check Music Status

Fetch the status and result payload for a music generation or extension task.

Base URL

https://apiin.one/api/v1

Use the unified API in One gateway for all Suno routes.

Polling

5-10 seconds

Poll periodically until the task completes or fails.

Result

Audio URLs

Completed responses include audio, image, title, and duration.

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

Fetch Music Task

Retrieve task status and completed Suno audio outputs.

After starting a generation or extension task, poll this endpoint to inspect generation progress and final results.

Body ParametersJSON

task_id: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?task_id=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": "chirp-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": "chirp-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": "chirp-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	}