Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lyrcs.ai/llms.txt

Use this file to discover all available pages before exploring further.

When align=true (the default), lyrcs.ai generates four downloadable files per job: two LRC files and two SRT files. Each format comes in an original variant (source language script) and a transliterated variant (romanised phonetic form).

​
LRC format

LRC (Lyric) is a plain-text format where each line is prefixed with a timestamp in [MM:SS.ss] format. 
[00:12.34]நான் உன்னை நேசிக்கிறேன்
[00:16.80]தெரியாமல் போனேன்
[00:21.15]உன் கண்களில் காணும்
[00:25.50]என் மனசு தொலைந்தது
LRC files are supported natively by most music players and karaoke apps and are the standard format for lyric display on streaming platforms.

​
SRT format

SRT (SubRip Subtitle) uses a numbered block format with start → end timecodes. It is the standard for video subtitles and is widely supported by video players and editing tools. 
1
00:00:12,340 --> 00:00:16,800
நான் உன்னை நேசிக்கிறேன்

2
00:00:16,800 --> 00:00:21,150
தெரியாமல் போனேன்

3
00:00:21,150 --> 00:00:25,500
உன் கண்களில் காணும்

​
Original vs transliterated

VariantContentUse case
_originalSource language script (e.g. Tamil script, Devanagari)Audiences who read the source script; DSP lyric display in source language
_transliteratedPhonetic romanisationAudiences who can’t read the script; karaoke sing-along; lyric apps for non-native listeners
The transliterated variant uses the same timestamps as the original — the timing is identical, only the text differs.

​
Download URLs

Both variants are available via the downloads object on a completed job: 
"downloads": {
  "lrc_original": "https://lyrcs.ai/api/v1/jobs/{id}/download/lrc/original",
  "lrc_transliterated": "https://lyrcs.ai/api/v1/jobs/{id}/download/lrc/transliterated",
  "srt_original": "https://lyrcs.ai/api/v1/jobs/{id}/download/srt/original",
  "srt_transliterated": "https://lyrcs.ai/api/v1/jobs/{id}/download/srt/transliterated"
}
All four URLs require Authorization: Bearer <key>.

​
When to use which format

ScenarioRecommended format
Spotify / Apple Music lyric deliverylrc_original
Karaoke app (source script display)lrc_original
Karaoke app (romanised sing-along)lrc_transliterated
Music video subtitlessrt_original
Subtitle track for non-native audiencesrt_transliterated
Lyrics editor / DAW importEither SRT

​
Not available for align=false jobs

If a job was submitted with align=false, no LRC or SRT files are generated. The downloads key is omitted from the job response. Use align=true (the default) if you need time-synced files.

​
Known limitations

Audio files in WAV or FLAC format may report duration_seconds: 0 in the job response. This is a known issue related to ffmpeg metadata extraction and does not affect the quality of the transcript or alignment output. MP3 and M4A files report accurate durations.