Get Lyrics Task Details

GET

/api/v1/lyrics/record-info

Retrieve detailed information about a lyrics generation task.

Usage Guide

Use this endpoint to check the status of a lyrics generation task

Retrieve generated lyrics content once the task is complete

Track task progress and access any error information if generation failed

Status Descriptions

PENDING: Task is waiting to be processed

SUCCESS: Lyrics generated successfully

CREATE_TASK_FAILED: Failed to create the task

GENERATE_LYRICS_FAILED: Failed during lyrics generation

CALLBACK_EXCEPTION: Error occurred during callback

SENSITIVE_WORD_ERROR: Content filtered due to sensitive words

Developer Notes

Successful tasks will include multiple lyrics variations

Each lyrics set includes both content and a suggested title

Error codes and messages are provided for failed tasks

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/lyrics/record-info?taskId=11dc****8b0f' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "11dc****8b0f",
        "param": "{\"prompt\":\"A song about peaceful night in the city\"}",
        "response": {
            "taskId": "11dc****8b0f",
            "data": [
                {
                    "text": "[Verse]\n我穿越城市黑暗夜\n心中燃烧梦想的烈火",
                    "title": "钢铁侠",
                    "status": "complete",
                    "errorMessage": ""
                }
            ]
        },
        "status": "SUCCESS",
        "type": "LYRICS",
        "errorCode": null,
        "errorMessage": null
    }
}

Generate Lyrics

Convert to WAV Callbacks

Get Lyrics Task Details

Usage Guide#

Status Descriptions#

Developer Notes#

Request

Responses

Usage Guide

Status Descriptions

Developer Notes