获取音乐封面生成详情

GET

/api/v1/suno/cover/record-info

使用指南

使用此接口检查Cover生成任务的状态

处理完成后访问生成的封面图片URL

跟踪处理进度和可能发生的任何错误

状态说明

PENDING: 任务等待处理中

SUCCESS: Cover生成成功完成

CREATE_TASK_FAILED: 创建Cover生成任务失败

GENERATE_COVER_FAILED: Cover图片生成过程中失败

开发者注意事项

封面图片URL仅在状态为SUCCESS时在响应中可用

对于失败的任务提供错误代码和消息

成功生成后，封面图片保留14天

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200

application/json

成功

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/suno/cover/record-info?taskId=21aee3c3c2a01fa5e030b3799fa4dd56' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "21aee3c3c2a01fa5e030b3799fa4dd56",
        "parentTaskId": "73d6128b3523a0079df10da9471017c8",
        "callbackUrl": "https://api.example.com/callback",
        "completeTime": "2025-01-15T10:35:27.000Z",
        "response": {
            "images": [
                "https://tempfile.aiquickdraw.com/s/1753958521_6c1b3015141849d1a9bf17b738ce9347.png",
                "https://tempfile.aiquickdraw.com/s/1753958524_c153143acc6340908431cf0e90cbce9e.png"
            ]
        },
        "successFlag": 1,
        "createTime": "2025-01-15T10:33:01.000Z",
        "errorCode": 200,
        "errorMessage": ""
    }
}

生成音乐封面

生成 Persona

获取音乐封面生成详情

使用指南#

状态说明#

开发者注意事项#

Request

Responses

使用指南

状态说明

开发者注意事项