Suno API Documentation

Basic Information

API Endpoints

Default endpoints:

https://api.crazyrouter.com/suno/submit/music
https://api.crazyrouter.com/suno/fetch

Model Support

Supported Models

chirp-v3-0 (corresponds to v3.0)

chirp-v3-5 (corresponds to v3.5 )

chirp-v4 (corresponds to v4.0 )

chirp-auk (corresponds to v4.5 )

chirp-v5 (corresponds to v5.0 )

Callback Notifications

Supports a notify_hook callback URL

Requirements:

Request method: POST

Payload received: 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 a song), LYRICS (generate lyrics)
status	string	SUCCESS	Task status: NOT_START (not started), SUBMITTED (submitted for processing), QUEUED (queued), IN_PROGRESS (running), FAILURE (failed), SUCCESS (succeeded)
submitTime	number	1689231405854	Submission time
startTime	number	1689231442755	Execution start time
finishTime	number	1689231544312	Finish time
failReason	string	[Invalid parameter] Invalid value	Failure reason (set on failure)
data	object	-	Payload: music (array) or lyrics (single object)

Extending Music

Pass the task_id parameter to specify the task

Last verified/modified: 2026-09-28 (Base URL changed to api.crazyrouter.com; the billing model name is suno_music; mv version parameters are determined by upstream Suno and were not run live this time)

Suno Overview

Suno API Documentation#

Basic Information#

API Endpoints#

Model Support#

Supported Models#

Callback Notifications#

Usage Steps#

1. Create a Suno task#

2. Query task progress#

Data Structures#

Task Object#

Extending Music#