Get Music Task Details

GET

/api/v1/generate/record-info

Retrieve detailed information about a music generation task.

Usage Guide

Use this endpoint to check task status and access generation results

Task details include status, parameters, and generated tracks

Generated tracks can be accessed through the returned URLs

Status Descriptions

PENDING: Task is waiting to be processed

TEXT_SUCCESS: Lyrics/text generation completed successfully

FIRST_SUCCESS: First track generation completed

SUCCESS: All tracks generated successfully

CREATE_TASK_FAILED: Failed to create task

GENERATE_AUDIO_FAILED: Failed to generate audio

CALLBACK_EXCEPTION: Error during callback process

SENSITIVE_WORD_ERROR: Content filtered due to sensitive words

Developer Notes

For instrumental tracks (instrumental=true), no lyrics data will be included

Maximum query rate: 3 requests per second per task

Response includes direct URLs to audio files, images, and streaming endpoints

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

Request successful

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

Add Vocals to Music

Get Timestamped Lyrics

Get Music Task Details

Usage Guide#

Status Descriptions#

Developer Notes#

Request

Responses

Usage Guide

Status Descriptions

Developer Notes