修改标题/封面

POST

/suno/submit/set-metadata

同步修改标题与封面

网站中的模型与调用示例

修改标题/封面

同步修改标题与封面

请求参数

{
  "contentType": "application/json",
  "properties": {
    "clip_id": {
      "type": "string"
    },
    "image_url": {
      "description": "新封面 URL",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "New cover URL"
        }
      }
    },
    "title": {
      "description": "新标题",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "new title"
        }
      }
    }
  },
  "required": [
    "clip_id",
    "title",
    "image_url"
  ]
}

请求示例 · 示例 1

{
  "clip_id": "e42808c7-e08a-4eb1-a288-1cd3ba952871",
  "image_url": "https://cdn2.suno.ai/image_e42808c7-e08a-4eb1-a288-1cd3ba952871.jpeg",
  "title": "新歌名"
}

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

修改标题/封面修改标题/封面 · 示例 1

{
    "clip_id": "e42808c7-e08a-4eb1-a288-1cd3ba952871",
    "title": "新歌名",
    "image_url": "https://cdn2.suno.ai/image_e42808c7-e08a-4eb1-a288-1cd3ba952871.jpeg"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

修改标题/封面修改标题/封面 · 示例 1

curl --location '/suno/submit/set-metadata' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "clip_id": "e42808c7-e08a-4eb1-a288-1cd3ba952871",
    "title": "新歌名",
    "image_url": "https://cdn2.suno.ai/image_e42808c7-e08a-4eb1-a288-1cd3ba952871.jpeg"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": "success",
    "message": "",
    "data": "1268154180129529857"
}

🟠400请求有误

🟠401没有权限

修改于 2026-10-24 18:33:20

调整播放速度

Fade 淡入淡出

修改标题/封面

网站中的模型与调用示例#

修改标题/封面#

请求参数#

请求示例 · 示例 1#

请求参数

请求示例代码

返回响应

网站中的模型与调用示例

修改标题/封面

请求参数

请求示例 · 示例 1