GET
/
api
/
v1
/
lyrics
/
record-info
Get Lyrics Task Details
curl --request GET \
  --url https://api.kie.ai/api/v1/lyrics/record-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "11dc****8b0f",
    "param": "{\"prompt\":\"A song about peaceful night in the city\"}",
    "response": {
      "taskId": "11dc****8b0f",
      "lyricsData": [
        {
          "text": "[Verse]\n我穿越城市黑暗夜\n心中燃烧梦想的烈火",
          "title": "钢铁侠",
          "status": "complete",
          "errorMessage": ""
        }
      ]
    },
    "status": "SUCCESS",
    "type": "LYRICS",
    "errorCode": null,
    "errorMessage": null
  }
}

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

Authorizations

Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Query Parameters

taskId
string
required

Unique identifier of the lyrics generation task to retrieve. This is the taskId returned when creating the lyrics generation task.

Response

200
application/json

Request successful

The response is of type object.