Suno API Documentation

Basic Information

API Endpoints

Default Endpoints:

https://{BASE_URL}/suno/submit/music
https://{BASE_URL}/suno/fetch

Model Support

Supported Models

chirp-v3-5 (Latest)

Model Features

Suno 3.5:

Supports creating songs up to 4 minutes long.

Supports extending songs by 2 minutes.

Improved song structure and smoother sound transitions.

Callback Notifications

Supports notify_hook callback URL.

Requirements:

Request Method: POST

Received Data: Task object structure.

Usage Steps

1. Create a Suno Task

The following modes are supported:

Custom Mode

Inspiration Mode

Lyrics Mode

2. Check Task Progress

Data Structure

Task Object

Field	Type	Example	Description
`task_id`	string	f4a94d75-087b-4bb1-bd45-53ba293faf96	Unique Task ID
`action`	string	MUSIC	Task type: `MUSIC` (generate song), `LYRICS` (generate lyrics)
`status`	string	SUCCESS	Task status: `NOT_START` (not started), `SUBMITTED` (submitted), `QUEUED` (queued), `IN_PROGRESS` (in progress), `FAILURE` (failed), `SUCCESS` (successful)
`submitTime`	number	1689231405854	Time of submission
`startTime`	number	1689231442755	Time when execution started
`finishTime`	number	1689231544312	Time when execution finished
`failReason`	string	[Invalid parameter] Invalid value	Reason for failure (only populated if the task fails)
`data`	object	-	Specific data: music (array) or lyrics (single item)

Music Extension

Requires the task_id parameter to specify the task.

Illustrate

Suno API Documentation#

Basic Information#

API Endpoints#

Model Support#

Supported Models#

Model Features#

Callback Notifications#

Usage Steps#

1. Create a Suno Task#

2. Check Task Progress#

Data Structure#

Task Object#

Music Extension#