POST
/v2/timestamped-lyricsTimestamped Lyrics API
Retrieve word-level lyric timestamps, waveform data, and alignment insights for a generated track.
POST
https://udioapi.pro/api/v2/timestamped-lyricstips
Call this endpoint after generation completes to get timed lyrics.
Provide audio_id and task_id.
requestHeaders
| name | required | description |
|---|---|---|
Authorization | yes | Bearer token for authentication |
Content-Type | yes | application/json |
requestBody
Provide both identifiers for alignment lookup
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
audio_id | string | yes | Audio asset ID from feed or callback | fc490335-ad97-4444-ac64-0fb21c0d4308 |
task_id | string | yes | Generation task identifier returned by generate or extend | gen2b9bb36e6c0cc44567aa34fbcff3afa64bksv |
responses
json
{
"code": 200,
"message": "success",
"data": {
"lyricAlignment": {
"words": [
{
"text": "[Verse]\nLola ",
"aligned": true,
"startTime": 0.55851,
"endTime": 0.87766,
"confidence": 0
},
{
"text": "Chouch, ",
"aligned": true,
"startTime": 0.91755,
"endTime": 1.91489,
"confidence": 0
}
]
},
"audioWaveform": [
0.00006,
0,
0.0339
],
"alignmentScore": 0.175,
"isStreaming": false
}
}codeExamples
curl
curl -X POST "https://udioapi.pro/api/v2/timestamped-lyrics" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"audio_id": "fc490335-ad97-4e08-ac64-0fb91c0d4308",
"task_id": "gen2b9bb36e6c0cc47969aa34fbcff3afa64bksv"
}'