
Suno V5.5
starting from
API Overview
Suno is an AI music generation platform developed by the U.S. company Suno Inc., enabling users to quickly create high-quality music featuring melodies, lyrics, and vocals through simple text prompts. Suno supports a variety of musical genres, including pop, electronic, R&B, and more, making it suitable for creators, advertising, short videos, and other applications. Users don’t need any prior musical expertise to get started, earning Suno the nickname "the ChatGPT of music."
API Console
Log in to explore more features! Click to Log In
API Analytics
API Reference (11)
| API Description | API Endpoint | Request Method | Stability | Parameter Description |
|---|---|---|---|---|
Music(Automatic Mode) | POST | Unstable | View Details | |
暂无数据 | ||||
Music(Custom Mode) | POST | Unstable | View Details | |
暂无数据 | ||||
Upload (Upload Material) | POST | Unstable | View Details | |
Document Details Upload materials for later use Price: 0.01PTC/time Request Parameters Header ParametersAuthorizationstringOptional Example Value: Bearer {{YOUR_API_KEY}}Content-TypestringOptional Example Value: application/jsonAcceptstringOptional Example Value: application/jsonRequest Body application/jsonurlstringRequired | ||||
Add Instrumental (Add Instrumental to A Cappella) | POST | Unstable | View Details | |
暂无数据 | ||||
Add Vocals (Add Vocals to Instrumental) | POST | Unstable | View Details | |
Document Details Add Vocals Feature Released by suno in August 2025
Usage Steps:
Price: 0.1PTC/time Request Parameters Header ParametersAuthorizationstringOptional Example Value: Bearer {{YOUR_API_KEY}}Content-TypestringOptional Example Value: application/jsonAcceptstringOptional Example Value: application/jsonRequest Body application/jsonmvenum<string>Required Only Suno-4.6 (chirp-bluejay) is supported Enum Value: chirp-bluejaytagsstringRequired Upload the metadata.tags after the query titlestringRequired Song Name overpainting_clip_idstringRequired clip_id after uploading and querying overpainting_start_sintegerRequired The second at which the background music starts, usually 0 overpainting_end_sintegerRequired Song Length taskenum<string>Required Fixed as overpainting Enum Value: overpaintingpromptstringRequired prompt is Fill in the blank, required override_fieldsarray[string]Required | ||||
Timing (Lyrics Timeline) | POST | Unstable | View Details | |
暂无数据 | ||||
Wav (Get Wav File) | POST | Unstable | View Details | |
Document Details Get Wav File Pass the id from the song generation API into task_id. Price: 0.01PTC/time Request Parameters Header ParametersAuthorizationstringOptional Example Value: Bearer {{YOUR_API_KEY}}Content-TypestringOptional Example Value: application/jsonAcceptstringOptional Example Value: application/jsonRequest Body application/jsontask_idstringRequired Last song generation task ID | ||||
Video (Get Video) | POST | Unstable | View Details | |
Document Details Get Video Pass the id from the song generation API into task_id. Price: 0.01PTC/time Request Parameters Header ParametersAuthorizationstringOptional Example Value: Bearer {{YOUR_API_KEY}}Content-TypestringOptional Example Value: application/jsonAcceptstringOptional Example Value: application/jsonRequest Body application/jsontask_idstringRequired Task ID of the last song generation | ||||
Speed (Adjust Song Speed) | POST | Unstable | View Details | |
暂无数据 | ||||
Crop (Trim Music) | POST | Unstable | View Details | |
暂无数据 | ||||
Fetch | GET | Unstable | View Details | |
Document Details Query the song generation status. Price: 0 PTC / call Request Parameters Path Parameterstask_idstringRequired Header ParametersAuthorizationstringOptional Example Value: Bearer {{YOUR_API_KEY}} | ||||
API Pricing
| Model | Description | 302.AI Price |
|---|
Music(Automatic Mode) | Suno Automatic Mode |
|
Music(Custom Mode) | Suno Automatic Mode |
|
Upload (Upload Material) | Upload Material |
|
Add Instrumental (Add Instrumental to A Cappella) | Add Instrumental to A Cappella |
|
Add Vocals (Add Vocals to Instrumental) | Add Vocals to Instrumental |
|
Timing (Lyrics Timeline) | Lyrics Timeline |
|
Wav (Get Wav File) | Get Wav File |
|
Video (Get Video) | Get Video |
|
Speed (Adjust Song Speed) | Adjust Song Speed |
|
Crop (Trim Music) | Trim Music |
|
Fetch | Fetch Task |
|