Suno MashupLyrics Generation API
POSThttps://api.acedata.cloud/suno/mashup-lyrics
Suno mashup lyrics API, merge two lyrics into a blended version.
Related Products
Suno - Ace Data Cloud
Suno music generation platform, directly interfaces with this API, high-speed and stable availability.
Request Headers
acceptstring
Specify the response format returned by the server.
Please select
authorizationstring
Bearer token
Request Body
lyrics_bstringRequired parameter
The content of the second verse for mixed-generated lyrics.
lyrics_astringRequired parameter
The first paragraph of lyrics content used for mixed generation.
Response
Success200
Request successful, returning normal result.
Response Body
dataobject
Output lyrics content generated by mixing the input lyrics.
tagsarray
List of content tags
Array of
String
textstring
Generated text content
titlestring
Title of Generated Content
statusstring
Processing status, for example, `complete` indicates that the processing is finished.
successboolean
A flag indicating whether this request was successful.
task_idstring
The unique ID of this task, which can be used to obtain the processing results of the asynchronous task through the corresponding task query interface.
Example
{
"data": {
"tags": [],
"text": "Sambuy come back \nBluespawn greenspawn are making you a spawn \n\n你在站里频频回头 \n我在站外舍不得走 \n有一种不祥的感受 \n今天的离别像分手 \n\nSambuy come back \nBluespawn greenspawn are making you a spawn \n\n你消失在人群之中 \n就像被风吹散的梦 \n广州南站人潮汹涌 \n有谁在乎我的心痛 \n\n我像个广州的孤儿 \n我像个多余的孤儿 \n我像个无助的孤儿 \n如今又是独自一人 \n\n一路平安我爱的人 \n一路珍重我爱的人 \n一路平安离去的人 \n一路珍重远去的人 \n\nSambuy come back \nBluespawn greenspawn are making you a spawn \nSambuy come back \nBluespawn greenspawn are making you a spawn \n\n坐在二号线地铁里 \n忽然感觉有些委屈 \n永泰站外飘着细雨 \n有谁在乎我的哭泣 \n\n在注定失眠的夜里 \n不知如何安慰自己 \n举杯敬自己和过去 \n今天终将成为回忆 \n\nSambuy come back \nBluespawn greenspawn are making you a spawn \nSambuy come back \nSambuy come back \n\n我像个广州的孤儿 \n我像个被弃的孤儿 \n我像个漂泊的孤儿 \n如今仍是独自一人 \n\n一生平安我爱的人 \n一生珍重我爱的人 \n一生平安离去的人 \n一生珍重远去的人 \n\n啦啦啦啦啦啦啦啦 \n啦啦啦啦啦啦啦啦 \nSambuy come back \nSambuy come back \n\n啦啦啦啦啦啦啦啦 \n啦啦啦啦啦啦啦啦 \n我像个广州的孤儿 \nSambuy come back bluespawn greenspawn are making you a spawn",
"title": "Lyrics Mashup",
"status": "complete"
},
"success": true,
"task_id": "97aea8af-9274-4f1e-9467-06259b8dbc97"
}Failure400token_mismatched
Request error, possibly due to missing or invalid parameters.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "token_mismatched",
"message": "The specified token is not matched with API."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure400api_not_implemented
Request error, possibly due to missing or invalid parameters.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "api_not_implemented",
"message": "The API is not implemented."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure400disabled
Request error, possibly due to missing or invalid parameters.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "disabled",
"message": "Your application has been disabled by Ace Data Cloud due to abnormal usage behavior, please contact our support to get more information."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure400bad_request
Request error, possibly due to missing or invalid parameters.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "bad_request",
"message": "model is invalid."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure400no_token
Request error, possibly due to missing or invalid parameters.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "no_token",
"message": "No token specified for the request."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure401invalid_token
Unauthorized, authorization token is invalid or missing.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "invalid_token",
"message": "The specified token is invalid or wrong."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure401token_expired
Unauthorized, authorization token is invalid or missing.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "token_expired",
"message": "token expired."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure401token_mismatched
Unauthorized, authorization token is invalid or missing.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "token_mismatched",
"message": "token and api does not match."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure403used_up
Unauthorized, authorization token is invalid or missing.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "used_up",
"message": "Your balance is not sufficient for current request, please buy more in Ace Data Cloud."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure404no_api
Unauthorized, the authorization token is invalid or missing.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "no_api",
"message": "API does not exist, please make sure url is correct."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure429too_many_requests
Too many requests, rate limit exceeded.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "too_many_requests",
"message": "You have exceeded the rate limit."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Failure500api_error
Internal server error, an exception occurred on the server side.
Response Body
errorobject
codestring
Response error code.
messagestring
Error message of the response.
trace_idstring
The tracking ID for this request.
Example
{
"error": {
"code": "api_error",
"message": "Internal server error."
},
"trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}Suno Music Generation
Allow Use General Balance
When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.
Shell
Python
JavaScript
Java
Go
PHP
Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.