Get Timestamped Lyrics

POST

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

Retrieve timestamped lyrics for synchronized display during audio playback.

Parameter Selection Logic

audioId parameter:

The audioId parameter is required to identify the exact track

Provides a unique identifier for the audio track within the generation task

Developer Notes

Timestamp values are in seconds

Returned waveform data can be used for audio visualization

For instrumental tracks (generated with instrumental=true), no lyrics data will be available

Typical use case: Karaoke-style lyrics display in music player interfaces

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Request successful

Bodyapplication/json

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://apibox.erweima.ai/api/v1/generate/get-timestamped-lyrics' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "taskId": "5c79****be8e",
    "audioId": "e231****-****-****-****-****8cadc7dc"
}'

Response Example

{
    "code": 200,
    "msg": "success",
    "data": {
        "alignedWords": [
            {
                "word": "[Verse]\nWaggin'",
                "success": true,
                "startS": 1.36,
                "endS": 1.79,
                "palign": 0
            }
        ],
        "waveformData": [
            0,
            1,
            0.5,
            0.75
        ],
        "hootCer": 0.3803191489361702,
        "isStreamed": false
    }
}

Get Recovery Audio Details

Boost Music Style

Get Timestamped Lyrics

Parameter Selection Logic#

Developer Notes#

Request

Responses

Parameter Selection Logic

Developer Notes