---
title: "Get Timestamped Lyrics"
method: POST
path: "/api/v1/generate/get-timestamped-lyrics"
---

# Get Timestamped Lyrics

`POST /api/v1/generate/get-timestamped-lyrics`

## Request body

- object
  - `taskId` string, required — The task ID of the music generation task. Required to identify which generation task contains the lyrics.
  - `audioId` string, required — Audio ID of the track to retrieve lyrics for.

## 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
    - `alignedWords` object[] — List of aligned lyrics words
      - `word` string — Lyrics word
      - `success` boolean — Whether lyrics word is successfully aligned
      - `startS` number — Word start time (seconds)
      - `endS` number — Word end time (seconds)
      - `palign` integer — Alignment parameter
    - `waveformData` number[] — Waveform data, used for audio visualization
    - `hootCer` number — Lyrics alignment accuracy score
    - `isStreamed` boolean — Whether it's streaming audio

## 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)