REST API

# 1. Create a key in Settings → API keys (paid plans only), then:
export KEY="llk_your_key_here"
export API="https://staging-api.lingivio.com"

# 2. Upload the file. The response carries the VERIFIED content type, the detected
#    source language and the real credit count — so you can price the job first.
#    (`page_count` is the same number under its old, misleading name; prefer `credits`.)
FILE=$(curl -s -X POST "$API/v1/files" \
  -H "Authorization: Bearer $KEY" \
  -F "file=@report.pdf")
echo "$FILE" | jq '{id, content_type, detected_source_language, credits}'
FILE_ID=$(echo "$FILE" | jq -r .id)

# 3. Start the translation. Idempotency-Key makes a retry safe: the same key with the
#    same body returns the SAME translation and is billed once.
JOB=$(curl -s -X POST "$API/v1/translations" \
  -H "Authorization: Bearer $KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "content-type: application/json" \
  -d '{"file_id":"'"$FILE_ID"'","target_language":"ar","side_by_side":true}')
JOB_ID=$(echo "$JOB" | jq -r .id)

# 4. Poll. progress.done / progress.total are REAL segment counts.
until [ "$(curl -s "$API/v1/translations/$JOB_ID" -H "Authorization: Bearer $KEY" | jq -r .status)" = "done" ]; do
  sleep 3
done

# 5. Download.
curl -s "$API/v1/translations/$JOB_ID/output" -H "Authorization: Bearer $KEY" -o report.ar.pdf

const API = 'https://staging-api.lingivio.com';
const KEY = process.env.LINGIVIO_KEY;
const auth = { Authorization: `Bearer ${KEY}` };

// 1. Upload
const form = new FormData();
form.append('file', new File([await Bun.file('report.pdf').arrayBuffer()], 'report.pdf'));
const file = await fetch(`${API}/v1/files`, { method: 'POST', headers: auth, body: form })
  .then((r) => r.json());
console.log(file.content_type, file.detected_source_language, file.credits);

// 2. Translate (idempotent)
let job = await fetch(`${API}/v1/translations`, {
  method: 'POST',
  headers: { ...auth, 'content-type': 'application/json', 'Idempotency-Key': crypto.randomUUID() },
  body: JSON.stringify({ file_id: file.id, target_language: 'ar', side_by_side: true }),
}).then((r) => r.json());

// 3. Poll on REAL segment counts
while (job.status !== 'done' && job.status !== 'failed') {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/v1/translations/${job.id}`, { headers: auth }).then((r) => r.json());
  console.log(job.progress.done, '/', job.progress.total);
}
if (job.status === 'failed') throw new Error(job.error.class); // stable, machine-readable

// 4. Download
const out = await fetch(`${API}/v1/translations/${job.id}/output`, { headers: auth });
await Bun.write('report.ar.pdf', await out.arrayBuffer());

import os
import time
import uuid
import httpx

API = "https://staging-api.lingivio.com"
auth = {"Authorization": f"Bearer {os.environ['LINGIVIO_KEY']}"}

with httpx.Client(base_url=API, headers=auth, timeout=120) as http:
    # 1. Upload
    with open("report.pdf", "rb") as fh:
        file = http.post("/v1/files", files={"file": ("report.pdf", fh)}).raise_for_status().json()
    print(file["content_type"], file["detected_source_language"], file["credits"])

    # 2. Translate (idempotent)
    job = http.post(
        "/v1/translations",
        headers={"Idempotency-Key": str(uuid.uuid4())},
        json={"file_id": file["id"], "target_language": "ar", "side_by_side": True},
    ).raise_for_status().json()

    # 3. Poll on REAL segment counts
    while job["status"] not in ("done", "failed"):
        time.sleep(3)
        job = http.get(f"/v1/translations/{job['id']}").raise_for_status().json()
        print(job["progress"]["done"], "/", job["progress"]["total"])
    if job["status"] == "failed":
        raise RuntimeError(job["error"]["class"])  # stable, machine-readable

    # 4. Download
    out = http.get(f"/v1/translations/{job['id']}/output").raise_for_status()
    open("report.ar.pdf", "wb").write(out.content)