Timing: lyrics, audio timeline
GET
https://api.cometapi.com/suno/act/timing/{clip_id}
Maintainer:Not configured
/suno/act/timing/{clip_id} endpoint retrieves precise word-level timing information for lyrics synchronized with the audio. This endpoint provides detailed alignment data including start time, end time, and confidence score for each word, making it ideal for creating karaoke displays, subtitle generation, lyric videos, or any application requiring precise lyric-audio synchronization.⚠️ Important Note:
You must wait until the music generation task is fully complete before calling this endpoint. Attempting to retrieve timing data for an incomplete task will result in an error. Use the Single task query endpoint to verify the task status iscompletebefore requesting timing information.
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.cometapi.com/suno/act/timing/db2b5b85-5fbb-45b6-b06b-5e9bc8e52bef' \
--header 'Authorization: Bearer 'Response Response Example
{
"aligned_words": [
{
"word": "[Verse]\nWhiskers ",
"success": true,
"start_s": 18.51064,
"end_s": 19.06915,
"p_align": 0.99
},
{
"word": "twitch ",
"success": true,
"start_s": 19.10904,
"end_s": 19.3883,
"p_align": 0.99
},
{
"word": "in ",
"success": true,
"start_s": 19.46809,
"end_s": 19.54787,
"p_align": 0.99
},
{
"word": "the ",
"success": true,
"start_s": 19.60106,
"end_s": 19.70745,
"p_align": 0.99
},
{
"word": "midnight ",
"success": true,
"start_s": 19.77726,
"end_s": 20.26596,
"p_align": 0.99
},
{
"word": "glow\n",
"success": true,
"start_s": 20.36569,
"end_s": 22.65957,
"p_align": 0.99
},
{
"word": "A ",
"success": true,
"start_s": 22.81915,
"end_s": 22.97872,
"p_align": 0.99
},
{
"word": "shadow ",
"success": true,
"start_s": 23.05851,
"end_s": 23.45745,
"p_align": 0.99
},
{
"word": "leaps ",
"success": true,
"start_s": 23.51064,
"end_s": 23.85638,
"p_align": 0.99
},
{
"word": "where ",
"success": true,
"start_s": 23.8883,
"end_s": 24.01596,
"p_align": 0.99
},
{
"word": "the ",
"success": true,
"start_s": 24.04255,
"end_s": 24.09574,
"p_align": 0.99
},
{
"word": "streetlights ",
"success": true,
"start_s": 24.14894,
"end_s": 24.73404,
"p_align": 0.99
},
{
"word": "go\n",
"success": true,
"start_s": 24.85372,
"end_s": 27.44681,
"p_align": 0.99
},
{
"word": "Silent ",
"success": true,
"start_s": 27.5266,
"end_s": 27.92553,
"p_align": 0.99
},
{
"word": "paws ",
"success": true,
"start_s": 28.00532,
"end_s": 28.24468,
"p_align": 0.99
},
{
"word": "on ",
"success": true,
"start_s": 28.32447,
"end_s": 28.40426,
"p_align": 0.99
},
{
"word": "a ",
"success": true,
"start_s": 28.56383,
"end_s": 28.56383,
"p_align": 0.99
},
{
"word": "rooftop ",
"success": true,
"start_s": 28.60372,
"end_s": 29.12234,
"p_align": 0.99
},
{
"word": "run\n",
"success": true,
"start_s": 29.22872,
"end_s": 30.23936,
"p_align": 0.99
},
{
"word": "Chasing ",
"success": true,
"start_s": 30.31915,
"end_s": 30.79787,
"p_align": 0.99
},
{
"word": "the ",
"success": true,
"start_s": 30.87766,
"end_s": 31.03723,
"p_align": 0.99
},
{
"word": "moon\n",
"success": true,
"start_s": 31.13697,
"end_s": 32.4734,
"p_align": 0.99
},
{
"word": "Chasing ",
"success": true,
"start_s": 32.55319,
"end_s": 33.03191,
"p_align": 0.99
},
{
"word": "the ",
"success": true,
"start_s": 33.1117,
"end_s": 33.27128,
"p_align": 0.99
},
{
"word": "sun\n\n",
"success": true,
"start_s": 33.37766,
"end_s": 36.34309,
"p_align": 0.99
},
{
"word": "[Chorus]\nNine ",
"success": true,
"start_s": 36.38298,
"end_s": 36.8617,
"p_align": 0.99
},
{
"word": "lives ",
"success": true,
"start_s": 36.95745,
"end_s": 37.5,
"p_align": 0.99
},
{
"word": "on ",
"success": true,
"start_s": 37.61968,
"end_s": 37.73936,
"p_align": 0.99
},
{
"word": "the ",
"success": true,
"start_s": 37.81915,
"end_s": 37.97872,
"p_align": 0.9Modified at 2025-11-24 09:01:30