quicklrc-transcribe#

Generate a time-synced lyrics or subtitle file from an audio or video URL using the QuickLRC API.

What it does#

• Auto-transcribe — sends an audio/video URL and gets back a synced subtitle file
• Force-align — provide plain-text lyrics and the API snaps each line to the audio
• Word-level timestamps — karaoke-style output with per-word timing
• Smart sections — auto-detect [Verse 1], [Chorus], etc.
• Supports YouTube URLs directly

Auth#

Set QUICKLRC_API_KEY to your API key from https://quicklrc.com/dashboard.

bash

export QUICKLRC_API_KEY=qlrc_...

Usage#

Auto-transcribe → LRC (default)#

bash

curl -X POST https://quicklrc.com/api/v1/transcribe \
  -H "Authorization: Bearer $QUICKLRC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileUrl": "https://example.com/song.mp3"}'

Force-align lyrics → LRC#

bash

curl -X POST https://quicklrc.com/api/v1/transcribe \
  -H "Authorization: Bearer $QUICKLRC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://example.com/song.mp3",
    "lyrics": "Hello world\nThis is line two"
  }'

Word-level karaoke + smart sections → SRT#

bash

curl -X POST https://quicklrc.com/api/v1/transcribe \
  -H "Authorization: Bearer $QUICKLRC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://example.com/song.mp3",
    "format": "srt",
    "isWordLevel": true,
    "smartSections": true
  }'

YouTube URL#

bash

curl -X POST https://quicklrc.com/api/v1/transcribe \
  -H "Authorization: Bearer $QUICKLRC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ", "format": "lrc"}'

Parameters#

FieldTypeRequiredDefaultDescriptionfileUrlstringyes—Public audio/video URL or YouTube URLlyricsstringno—Plain-text lyrics for forced alignmentformatstringnolrc``lrc, srt, webvtt, ass, ttml, txt``isWordLevelbooleannofalsePer-word timestamps (karaoke)smartSectionsbooleannofalseAuto-insert [Verse 1], [Chorus] labels

Response#

HTTP 200 — plain text subtitle file in the requested format.

Credits#

Cost = audio duration rounded up to the nearest minute. Failed requests are not charged. Check remaining credits at https://quicklrc.com/dashboard.

Errors#

StatusMeaning401Invalid or missing API key400Missing fileUrl or invalid format402File duration exceeds remaining credits403Usage limit exceeded500Processing error — not charged