suno-single-v5

POST

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

用户输入一句话描述歌曲内容，模型自动生成两首完整歌曲。v5版本核心升级在于录音棚级别的音质——人声逼真度大幅提升，混音声场和乐器分离度达到专业水准，基本消除“电子机械味”。适用于高质量背景音乐制作、内容创作者配乐、快速Demo生成。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "description": "中国传统民谣，70 BPM，古筝琶音，笛子独奏，柔和女声，五声音阶，古代宫殿，月光，诗意，忧郁，重混响。",
    "make_instrumental": "false"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.runninghub.cn/openapi/v2/rhart-audio/suno-v5/single' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data '{
    "description": "中国传统民谣，70 BPM，古筝琶音，笛子独奏，柔和女声，五声音阶，古代宫殿，月光，诗意，忧郁，重混响。",
    "make_instrumental": "false"
}'

返回响应

🟢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-07-30 07:04:26

suno-custom-v5.5

suno-custom-v5