---
title: "Get Lyrics Generation Details"
method: GET
path: "/api/v1/lyrics/record-info"
---

# Get Lyrics Generation Details

`GET /api/v1/lyrics/record-info`

## Query parameters

- `taskId` string, required

## Response `200`

Request successful

- object
  - `code` 200 | 400 | 401 | 404 | 405 | 413 | 429 | 430 | 455 | 500 — # Status Codes - ✅ 200 - Request successful - ⚠️ 400 - Invalid parameters - ⚠️ 401 - Unauthorized access - ⚠️ 404 - Invalid request method or path - ⚠️ 405 - Rate limit exceeded - ⚠️ 413 - Theme or prompt too long - ⚠️ 429 - Insufficient credits - ⚠️ 430 - Your call frequency is too high. Please try again later. - ⚠️ 455 - System maintenance - ❌ 500 - Server error
  - `msg` string — Error message when code != 200
  - `data` object
    - `taskId` string — Task ID
    - `param` string — Parameter information for task generation
    - `response` object
      - `taskId` string — Task ID
      - `data` object[]
        - `text` string — Lyrics content
        - `title` string — Lyrics title
        - `status` 'complete' | 'failed' — Generation status
        - `errorMessage` string — Error message, valid when status is failed
    - `status` 'PENDING' | 'SUCCESS' | 'CREATE_TASK_FAILED' | 'GENERATE_LYRICS_FAILED' | 'CALLBACK_EXCEPTION' | 'SENSITIVE_WORD_ERROR' — Task status
    - `type` string — Task type
    - `errorCode` number — Error code, valid when task fails
    - `errorMessage` string — Error message, valid when task fails

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)