Quickstart

curl -X POST https://lyrcs.ai/api/v1/transcribe \
  -H "Authorization: Bearer $LYRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/song.mp3",
    "language": "Tamil"
  }'

const response = await fetch("https://lyrcs.ai/api/v1/transcribe", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LYRCS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    audio_url: "https://example.com/song.mp3",
    language: "Tamil",
  }),
});

const { job_id } = await response.json();
console.log("Job queued:", job_id);

import os, requests

response = requests.post(
    "https://lyrcs.ai/api/v1/transcribe",
    headers={"Authorization": f"Bearer {os.environ['LYRCS_API_KEY']}"},
    json={
        "audio_url": "https://example.com/song.mp3",
        "language": "Tamil",
    },
)

job_id = response.json()["job_id"]
print("Job queued:", job_id)

curl https://lyrcs.ai/api/v1/jobs/a1b2c3d4-... \
  -H "Authorization: Bearer $LYRCS_API_KEY"

async function waitForJob(jobId, apiKey, { intervalMs = 10000, timeoutMs = 180000 } = {}) {
  const deadline = Date.now() + timeoutMs;

  while (Date.now() < deadline) {
    const res = await fetch(`https://lyrcs.ai/api/v1/jobs/${jobId}`, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const job = await res.json();

    if (job.status === "complete") return job;
    if (job.status === "failed") throw new Error("Job failed: " + jobId);

    await new Promise((r) => setTimeout(r, intervalMs));
  }

  throw new Error("Job timed out after 3 minutes");
}

const job = await waitForJob("a1b2c3d4-...", process.env.LYRCS_API_KEY);
console.log("Transcript:", job.results.transcript);

import os, time, requests

def wait_for_job(job_id, api_key, interval=10, timeout=180):
    headers = {"Authorization": f"Bearer {api_key}"}
    deadline = time.time() + timeout

    while time.time() < deadline:
        r = requests.get(
            f"https://lyrcs.ai/api/v1/jobs/{job_id}",
            headers=headers,
        )
        job = r.json()

        if job["status"] == "complete":
            return job
        if job["status"] == "failed":
            raise RuntimeError(f"Job failed: {job_id}")

        time.sleep(interval)

    raise TimeoutError("Job timed out after 3 minutes")

job = wait_for_job("a1b2c3d4-...", os.environ["LYRCS_API_KEY"])
print("Transcript:", job["results"]["transcript"])

curl https://lyrcs.ai/api/v1/jobs/a1b2c3d4-.../download/lrc/original \
  -H "Authorization: Bearer $LYRCS_API_KEY" \
  -o song.lrc

const lrcUrl = job.results.downloads.lrc_original;
const res = await fetch(lrcUrl, {
  headers: { Authorization: `Bearer ${process.env.LYRCS_API_KEY}` },
});
const lrcText = await res.text();
// lrcText is a standard LRC file ready for delivery

lrc_url = job["results"]["downloads"]["lrc_original"]
r = requests.get(
    lrc_url,
    headers={"Authorization": f"Bearer {os.environ['LYRCS_API_KEY']}"},
)
with open("song.lrc", "w") as f:
    f.write(r.text)