获取音乐任务详情

GET

/api/v1/generate/record-info

获取音乐生成任务的详细信息。

使用指南

使用此接口检查任务状态并访问生成结果

任务详情包括状态、参数和生成的曲目

生成的曲目可通过返回的URL访问

状态说明

PENDING: 任务等待处理中

TEXT_SUCCESS: 歌词/文本生成成功

FIRST_SUCCESS: 第一个音轨生成完成

SUCCESS: 所有音轨生成成功

CREATE_TASK_FAILED: 创建任务失败

GENERATE_AUDIO_FAILED: 音频生成失败

CALLBACK_EXCEPTION: 回调过程中出错

SENSITIVE_WORD_ERROR: 内容因敏感词被过滤

开发者注意事项

对于纯音乐曲目（instrumental=true），响应中不会包含歌词数据

最大查询频率：每个任务每秒最多3次请求

响应包括音频文件、图片和流式端点的直接URL

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

请求成功

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.kie.ai/api/v1/generate/record-info?taskId=5c79****be8e' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "5c79****be8e",
        "parentMusicId": "",
        "param": "{\"prompt\":\"A calm piano track\",\"style\":\"Classical\",\"title\":\"Peaceful Piano\",\"customMode\":true,\"instrumental\":true,\"model\":\"V3_5\"}",
        "response": {
            "taskId": "5c79****be8e",
            "sunoData": [
                {
                    "id": "e231****-****-****-****-****8cadc7dc",
                    "audioUrl": "https://example.cn/****.mp3",
                    "streamAudioUrl": "https://example.cn/****",
                    "imageUrl": "https://example.cn/****.jpeg",
                    "prompt": "[Verse] 夜晚城市 灯火辉煌",
                    "modelName": "chirp-v3-5",
                    "title": "钢铁侠",
                    "tags": "electrifying, rock",
                    "createTime": "2025-01-01 00:00:00",
                    "duration": 198.44
                }
            ]
        },
        "status": "SUCCESS",
        "type": "GENERATE",
        "errorCode": null,
        "errorMessage": null
    }
}

添加人声生成音乐

获取带时间戳的歌词

获取音乐任务详情

使用指南#

状态说明#

开发者注意事项#

Request

Responses

使用指南

状态说明

开发者注意事项