Illustrate
Suno API Documentation
Basic Information
API Endpoints
- Default Endpoints:
(Code extracted to sandbox)
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_hookcallback 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_idparameter to specify the task.