Skip to main content
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.
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.

Original vs transliterated

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:
All four URLs require Authorization: Bearer <key>.

When to use which format

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.

Word-level JSON format

When word_align=true (the default), lyrcs.ai also generates per-word timestamps alongside the line-level LRC and SRT files. These are returned as a JSON array — one entry per word — from GET /api/v1/jobs/{id}/download/words/original and .../download/words/transliterated. Each entry contains the word text and its start timestamp in [MM:SS.XX] format:
The words_transliterated variant uses the same timestamps mapped to the Roman script words:
Use cases for word-level timestamps:
  • Karaoke with word-by-word highlight (bouncing ball)
  • Accessibility features requiring word-precise sync
  • Custom lyric renderers that need sub-line granularity
Already have lyrics? There is currently no way to time lyrics you already hold against audio we have not transcribed — the endpoint that offered this has been withdrawn. Alignment runs as part of POST /transcribe.

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.