KIE.AI
Chinese
  • English
  • Chinese
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation
  • Suno API 快速开始
  • Music Generation
    • 生成音乐回调
    • 音乐扩展回调
    • 音频上传和翻唱回调
    • 音频上传和扩展回调
    • 添加伴奏回调
    • 添加人声回调
    • 音乐封面生成回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏生成音乐
      POST
    • 添加人声生成音乐
      POST
    • 获取音乐任务详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 替换音乐分区
      POST
    • 生成音乐封面
      POST
    • 获取音乐封面生成详情
      GET
    • 生成 Persona
      POST
  • Lyrics Generation
    • 生成歌词回调
    • 生成歌词
      POST
    • 获取歌词任务详情
      GET
  • WAV Conversion
    • 转换为WAV格式回调
    • 转换为WAV格式
      POST
    • 获取WAV转换详情
      GET
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
    • 人声和乐器分离
    • 获取人声和乐器分离详情
  • Music Video Generation
    • MP4生成完成回调
    • 创建音乐视频
    • 获取音乐视频详情
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation

获取音乐封面生成详情

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 ********************
or
Query Params

Responses

🟢200
application/json
成功
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kie.ai/api/v1/suno/cover/record-info?taskId=21aee3c3c2a01fa5e030b3799fa4dd56' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - 成功示例
{
    "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": ""
    }
}
Previous
生成音乐封面
Next
生成 Persona
Built with