Batch

# Submit batch
curl -X POST https://lyrcs.ai/api/v1/batch \
  -H "Authorization: Bearer $LYRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://api.example.com/webhooks/lyrcs",
    "jobs": [
      { "audio_url": "https://cdn.example.com/song-1.mp3", "language": "Hindi" },
      { "audio_url": "https://cdn.example.com/song-2.mp3", "language": "Tamil" },
      { "audio_url": "https://cdn.example.com/song-3.mp3", "language": "Telugu" }
    ]
  }'

# Poll batch status
curl https://lyrcs.ai/api/v1/batch/b1a2t3c4-... \
  -H "Authorization: Bearer $LYRCS_API_KEY"

// Submit
const res = await fetch("https://lyrcs.ai/api/v1/batch", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LYRCS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    webhook_url: "https://api.example.com/webhooks/lyrcs",
    jobs: [
      { audio_url: "https://cdn.example.com/song-1.mp3", language: "Hindi", external_id: "TRACK_001" },
      { audio_url: "https://cdn.example.com/song-2.mp3", language: "Tamil", external_id: "TRACK_002" },
    ],
  }),
});
const { batch_id } = await res.json();

// Poll
// A 20-song batch can legitimately take 15+ minutes. This deadline is a
// safety net against a hung client, not a failure signal — the batch itself
// reports `complete` or `partial` when it is genuinely done.
async function waitForBatch(batchId, apiKey, { intervalMs = 15000, timeoutMs = 2_400_000 } = {}) {
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const r = await fetch(`https://lyrcs.ai/api/v1/batch/${batchId}`, {
      headers: { Authorization: `Bearer ${apiKey}` },
    });
    const batch = await r.json();
    if (batch.status === "complete" || batch.status === "partial") return batch;
    await new Promise((res) => setTimeout(res, intervalMs));
  }
  throw new Error("Batch timed out");
}

const batch = await waitForBatch(batch_id, process.env.LYRCS_API_KEY);
const failed = batch.jobs.filter((j) => j.status === "failed");
if (failed.length) console.warn(`${failed.length} jobs failed`);

import os, time, requests

api_key = os.environ["LYRCS_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}"}

# Submit
r = requests.post(
    "https://lyrcs.ai/api/v1/batch",
    headers=headers,
    json={
        "webhook_url": "https://api.example.com/webhooks/lyrcs",
        "jobs": [
            {"audio_url": "https://cdn.example.com/song-1.mp3", "language": "Hindi", "external_id": "TRACK_001"},
            {"audio_url": "https://cdn.example.com/song-2.mp3", "language": "Tamil", "external_id": "TRACK_002"},
        ],
    },
)
batch_id = r.json()["batch_id"]

# Poll
# A 20-song batch can legitimately take 15+ minutes. This deadline is a safety
# net against a hung client, not a failure signal — the batch itself reports
# "complete" or "partial" when it is genuinely done.
def wait_for_batch(batch_id, interval=15, timeout=2400):
    deadline = time.time() + timeout
    while time.time() < deadline:
        r = requests.get(f"https://lyrcs.ai/api/v1/batch/{batch_id}", headers=headers)
        batch = r.json()
        if batch["status"] in ("complete", "partial"):
            return batch
        time.sleep(interval)
    raise TimeoutError("Batch timed out")

batch = wait_for_batch(batch_id)
failed = [j for j in batch["jobs"] if j["status"] == "failed"]
if failed:
    print(f"{len(failed)} jobs failed")