suno-custom-v5

POST

/openapi/v2/rhart-audio/suno-v5/custom

Custom lyrics and style tags. Output: Two alternative songs generated following the instructions. v5 enhances response precision for complex arrangement commands, handling user-specified instruments, tempo, mood, and other details more accurately. Users can iteratively generate multiple versions until satisfied. Supports multiple languages (Chinese, English, Japanese, etc.).

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "title": "Scenery of Mount Emei",
    "prompt": "[Verse] Before the mirror, pines and cypresses shrouded in mist stretch long Reflected in the water, white silk and jade bridge rise high Layered peaks like a painting, wind and rain sway Who can imitate the green mountains when the brush falls?  [Chorus] Ancient path of a thousand years, the divine path is vast White clouds hide Clear breeze rises Buddha's light descends  [Verse 2] Resting on Mount Emei, the heart feels refreshed The Dao's essence, heaven-bestowed immortal appearance Unafraid of floating clouds blocking the sight By fate, standing at the highest level  [Chorus] Ancient path of a thousand years, the divine path is vast White clouds hide Clear breeze rises Buddha's light descends",
    "tags": "chinese, cinematic, orchestral"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.ai/openapi/v2/rhart-audio/suno-v5/custom' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "title": "Scenery of Mount Emei",
    "prompt": "[Verse] Before the mirror, pines and cypresses shrouded in mist stretch long Reflected in the water, white silk and jade bridge rise high Layered peaks like a painting, wind and rain sway Who can imitate the green mountains when the brush falls?  [Chorus] Ancient path of a thousand years, the divine path is vast White clouds hide Clear breeze rises Buddha'\''s light descends  [Verse 2] Resting on Mount Emei, the heart feels refreshed The Dao'\''s essence, heaven-bestowed immortal appearance Unafraid of floating clouds blocking the sight By fate, standing at the highest level  [Chorus] Ancient path of a thousand years, the divine path is vast White clouds hide Clear breeze rises Buddha'\''s light descends",
    "tags": "chinese, cinematic, orchestral"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Bodyapplication/json

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-07-30 07:05:27

suno-single-v5

suno-single-v4.5