Build with audio-to-text

const TOKEN = process.env.TFT_TOKEN;
const BASE  = "https://app.textfromtrack.com/api/v1";
const HDR   = { Authorization: `Bearer ${TOKEN}` };
const sleep = ms => new Promise(r => setTimeout(r, ms));

async function getLyrics(filePath, format = "lrc") {
  // 1 — Submit
  const fd = new FormData();
  fd.append("file", fs.createReadStream(filePath)); // Node.js
  const sub = await fetch(`${BASE}/transcriptions`, {
    method: "POST", headers: HDR, body: fd,
  }).then(r => r.json());
  if (!sub.job_id) throw sub;
  console.log(`Submitted — ${sub.job_id}`);

  // 2 — Poll
  let job;
  do {
    await sleep(2000);
    job = await fetch(`${BASE}/transcriptions/${sub.job_id}`, { headers: HDR })
            .then(r => r.json());
    console.log(` → ${job.status}`);
    if (job.status === "error") throw new Error(job.error);
  } while (job.status !== "done");

  // 3 — Download export
  const res = await fetch(`${BASE}/transcriptions/${sub.job_id}/export?format=${format}`, { headers: HDR });
  return res.text();
}

// Usage
getLyrics("track.mp3", "lrc").then(lrc => console.log(lrc));

$ TFT_TOKEN="tft_pat_…"
$ BASE="https://app.textfromtrack.com/api/v1"

# Check credit balance
$ curl -s -H "Authorization: Bearer $TFT_TOKEN" "$BASE/me" | jq .credit_balance

# Submit (with pinyin for a Chinese track)
$ JOB=$(curl -s -X POST "$BASE/transcriptions" \
    -H "Authorization: Bearer $TFT_TOKEN" \
    -F "file=@song.mp3" \
    -F "pinyin=true" | jq -r .job_id)
$ echo "job_id: $JOB"

# Poll until done
$ while true; do
    STATUS=$(curl -s -H "Authorization: Bearer $TFT_TOKEN" \
      "$BASE/transcriptions/$JOB" | jq -r .status)
    echo "  $STATUS"
    [ "$STATUS" = "done" ] && break
    [ "$STATUS" = "error" ] && exit 1
    sleep 2
  done

# Download all 4 formats
$ for FMT in txt srt lrc json; do
    curl -s -H "Authorization: Bearer $TFT_TOKEN" \
      "$BASE/transcriptions/$JOB/export?format=$FMT" \
      -o "song.$FMT"
    echo "song.$FMT ✓"
  done