Generate Music Cover

POST

/api/v1/suno/cover/generate

Generate personalized cover images based on original music tasks.

Usage Guide

Use this interface to create personalized cover images for generated music

Requires the taskId of the original music task

Each music task can only generate a Cover once; duplicate requests will return the existing taskId

Results will be notified through the callback URL upon completion

Parameter Details

taskId identifies the unique identifier of the original music generation task

callBackUrl receives callback address for completion notifications

Developer Notes

Cover image file URLs will be retained for 14 days

If a Cover has already been generated for this music task, a 400 status code and existing taskId will be returned

It's recommended to call this interface after music generation is complete

Usually generates 2 different style images for selection

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

Success

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"
    }
}

Boost Music Style

Get Cover Generation Details