文档 / 音乐系列 / Suno / 辅助功能
辅助功能POSTSunopromptupsamplesuno_prompts_upsample
润色风格标签
把风格标签和歌词润色扩写成更完整的风格描述。
Bearer API KeyJSON服务端调用
用途#
把一段风格标签与歌词润色扩写成更完整的风格描述，帮助生成更贴合预期的音乐。该接口为同步透传，请求体透传上游处理，直接返回结果。
请求字段#
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
original_tags | string | 是 | — | 原始风格或标签串 |
lyrics | string | 否 | — | 歌词，纯器乐可留空 |
is_instrumental | bool | 否 | false | 是否纯器乐 |
请求体透传上游，relay 侧不做业务解析；字段以上游实际支持为准。
请求示例#
cURL
curl --request POST \
--url https://api.apimax.ai/v1/music/prompts/upsample \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"original_tags": "lofi, chill",
"lyrics": "...",
"is_instrumental": false
}'成功响应#
200
{
"code": "success",
"message": "",
"data": {
"upsampled": "润色后的风格描述",
"request_id": "上游请求 id"
}
}响应字段#
| 字段 | 类型 | 说明 |
|---|---|---|
upsampled | string | 润色扩写后的风格描述 |
request_id | string | 上游请求 ID，便于排查问题 |
相关说明#
- 该接口仅做风格描述润色，不创建生成任务。
- 润色后的结果可作为
tags或gpt_description_prompt传给音乐生成接口。