生成音乐封面

POST

/api/v1/suno/cover/generate

为已生成的音乐创建个性化封面图片。

使用指南

使用此接口为已生成的音乐创建个性化封面图片

需要提供原音乐任务的 taskId

每个音乐任务只能生成一次 Cover，重复请求会返回已存在的 taskId

生成完成后会通过回调 URL 通知结果

参数详情

taskId：标识原始音乐生成任务的唯一标识符

callBackUrl：用于接收生成完成通知的回调地址

开发者注意事项

封面图片文件 URL 将保留 14 天

如果该音乐任务已生成过 Cover，将返回 400 状态码和已存在的 taskId

建议在音乐生成完成后再调用此接口

生成的封面图片通常为 2 张 不同风格的图片供选择

Callbacks

onCoverGenerated

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

成功

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kie.ai/api/v1/suno/cover/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskId": "73d6128b3523a0079df10da9471017c8",
    "callBackUrl": "https://api.example.com/callback"
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "21aee3c3c2a01fa5e030b3799fa4dd56"
    }
}

替换音乐分区

获取音乐封面生成详情