Overview

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-0 (version v3.0)
• chirp-v3-5 (version v3.5)
• chirp-v4 (version v4.0)
• chirp-auk (version v4.5)
• chirp-v5 (version v5.0)

Callback Notifications

• Supports notify_hook callback URL
• Requirements:
  • Method: POST
  • Payload: task data structure

Usage Steps

1. Create a Suno Task

2. Query Task Progress

Data Structures

Task Object

Field	Type	Example	Description
task_id	string	f4a94d75-087b-4bb1-bd45-53ba293faf96	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 (succeeded)
submitTime	number	1689231405854	Submission time
startTime	number	1689231442755	Start time
finishTime	number	1689231544312	Finish time
failReason	string	[Invalid parameter] Invalid value	Failure reason (present when failed)
data	object	-	Payload: music (array) or lyrics (single object)

Music Continuation

• Pass the task_id parameter to specify the task