suno-custom-v5

POST

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

用户输入自定义歌词文本和风格标签，模型根据这些指令生成两首备选歌曲。v5版本强化了对复杂编曲指令的响应精度，能更准确地处理用户指定的乐器、节奏、情绪等细节。用户可迭代生成多个版本直到满意。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "title": "峨眉风光",
    "prompt": "[Verse] 对镜松柏云雾长 映水白练玉桥扬 如画层峦风雨荡 落笔青山谁能仿  [Chorus] 千载古道神道苍 白云藏 清风扬 佛光降  [Verse 2] 栖息峨眉心气爽 道骨天赐仙姿象 不惧浮云遮望眼 自缘身在最高层  [Chorus] 千载古道神道苍 白云藏 清风扬 佛光降",
    "tags": "中国风，电影感，管弦乐"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.cn/openapi/v2/rhart-audio/suno-v5/custom' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "title": "峨眉风光",
    "prompt": "[Verse] 对镜松柏云雾长 映水白练玉桥扬 如画层峦风雨荡 落笔青山谁能仿  [Chorus] 千载古道神道苍 白云藏 清风扬 佛光降  [Verse 2] 栖息峨眉心气爽 道骨天赐仙姿象 不惧浮云遮望眼 自缘身在最高层  [Chorus] 千载古道神道苍 白云藏 清风扬 佛光降",
    "tags": "中国风，电影感，管弦乐"
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Bodyapplication/json

示例

提交任务响应示例任务完成（查询状态接口）响应示例

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

修改于 2026-04-27 12:00:02

suno-single-v5

suno-single-v4.5