GET
/
suno
/
aligned_lyrics
/
{taskId}
Get Timestamped Lyrics
curl --request GET \
  --url https://api.unifically.com/suno/aligned_lyrics/{taskId} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "<string>",
  "a": {
    "state": "<string>",
    "alignment": [
      {
        "word": "<string>",
        "success": true,
        "start_s": 123,
        "end_s": 123,
        "p_align": 123
      }
    ]
  },
  "b": {}
}
Get timestamped/aligned lyrics for a song.

​
Request Example

curl "https://api.unifically.com/suno/aligned_lyrics/64ea9bb1-e8d0-4395-a4c4-b70d2fa0e3b4" \
  -H "Authorization: Bearer YOUR_API_KEY"
Replace 64ea9bb1-e8d0-4395-a4c4-b70d2fa0e3b4 with your actual task ID.

​
Response

{
  "code": 200,
  "data": {
    "task_id": "68c911ac-c8f4-4a4f-b7c4-eb6fa4f8ae92",
    "a": {
      "state": "complete",
      "alignment": [
        {
          "word": "[Verse]\nStreet",
          "success": true,
          "start_s": 9.89362,
          "end_s": 10.21277,
          "p_align": 1
        },
        {
          "word": "lights",
          "success": true,
          "start_s": 10.21277,
          "end_s": 10.6117,
          "p_align": 1
        },
        {
          "word": " blur",
          "success": true,
          "start_s": 10.6117,
          "end_s": 11.01064,
          "p_align": 1
        }
      ]
    },
    "b": {
      "state": "complete",
      "alignment": [
        {
          "word": "[Verse]\nStreet",
          "success": true,
          "start_s": 10.53191,
          "end_s": 10.85106,
          "p_align": 1
        },
        {
          "word": "lights",
          "success": true,
          "start_s": 10.85106,
          "end_s": 11.25,
          "p_align": 1
        },
        {
          "word": " blur",
          "success": true,
          "start_s": 11.25,
          "end_s": 11.64894,
          "p_align": 1
        }
      ]
    },
    "error": {}
  }
}

​
Response Fields

The API returns timestamped lyrics for two variations (a and b):
​
task_id
string
Task identifier
​
a
object
First variation’s timestamped lyrics
​
state
string
Status: complete, pending, or failed
​
alignment
array
Array of word-level timestamps
​
word
string
Word or phrase (may include verse markers)
​
success
boolean
Whether alignment was successful
​
start_s
number
Start time in seconds
​
end_s
number
End time in seconds
​
p_align
number
Alignment confidence (0.0-1.0)
​
b
object
Second variation’s timestamped lyrics (same structure as a)

​
Use Cases

  • Creating karaoke-style displays
  • Syncing lyrics to audio playback
  • Analyzing vocal timing
  • Building lyric visualization tools