Running Review In Your Own Product

const API = "https://lyrcs.ai/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.LYRCS_API_KEY}`,
  "Content-Type": "application/json",
};

async function submit(audioUrl: string, language: string, customerId: string) {
  const res = await fetch(`${API}/transcribe`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      audio_url: audioUrl,
      language,
      review: true,
      review_stage: "transcript",
      review_delivery: "api",
      end_user: { external_id: customerId },
    }),
  });
  if (!res.ok) throw new Error(`submit failed: ${res.status}`);
  return (await res.json()).job_id as string;
}

// Find everything waiting on a human, in one call, without polling job by job.
async function jobsAwaitingReview(since: string) {
  const res = await fetch(
    `${API}/jobs?updated_since=${encodeURIComponent(since)}&limit=100`,
    { headers }
  );
  const { jobs } = await res.json();
  return jobs.filter(
    (j: any) => j.review_required && j.review_approved_at === null
  );
}

async function getHeldJob(jobId: string) {
  const res = await fetch(`${API}/jobs/${jobId}`, { headers });
  const job = await res.json();
  if (!job.review) return null; // not held — already approved, or not there yet
  return job;
}

async function approve(
  jobId: string,
  lines?: string[],
  transliteratedLines?: string[]
) {
  const res = await fetch(`${API}/jobs/${jobId}/approve`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      ...(lines ? { lines } : {}),
      ...(transliteratedLines ? { transliterated_lines: transliteratedLines } : {}),
    }),
  });
  const body = await res.json();

  // 502 APR_004 means the edits saved but the release failed. The approval was
  // rolled back, so retrying is a clean repeat rather than a no-op.
  if (res.status === 502 && body.code === "APR_004") {
    return approve(jobId, lines, transliteratedLines);
  }
  if (!res.ok) throw new Error(`${body.code}: ${body.message}`);
  return body;
}

import os, requests

API = "https://lyrcs.ai/api/v1"
HEADERS = {
    "Authorization": f"Bearer {os.environ['LYRCS_API_KEY']}",
    "Content-Type": "application/json",
}

def submit(audio_url, language, customer_id):
    r = requests.post(f"{API}/transcribe", headers=HEADERS, json={
        "audio_url": audio_url,
        "language": language,
        "review": True,
        "review_stage": "transcript",
        "review_delivery": "api",
        "end_user": {"external_id": customer_id},
    })
    r.raise_for_status()
    return r.json()["job_id"]

def jobs_awaiting_review(since):
    r = requests.get(f"{API}/jobs", headers=HEADERS,
                     params={"updated_since": since, "limit": 100})
    r.raise_for_status()
    return [j for j in r.json()["jobs"]
            if j["review_required"] and j["review_approved_at"] is None]

def get_held_job(job_id):
    job = requests.get(f"{API}/jobs/{job_id}", headers=HEADERS).json()
    return job if job.get("review") else None

def approve(job_id, lines=None, transliterated_lines=None):
    payload = {}
    if lines is not None:
        payload["lines"] = lines
    if transliterated_lines is not None:
        payload["transliterated_lines"] = transliterated_lines

    r = requests.post(f"{API}/jobs/{job_id}/approve", headers=HEADERS, json=payload)
    body = r.json()

    # 502 APR_004: edits saved, release failed, approval rolled back. Retry.
    if r.status_code == 502 and body.get("code") == "APR_004":
        return approve(job_id, lines, transliterated_lines)
    r.raise_for_status()
    return body