Lab Forge documentation

Lab Forge takes a source file from upload to a checked, deliverable translation. Translators work in the review page; project managers set up projects, glossaries and client rules.

1. 1Create a project: client name plus source and target languages.
2. 2Upload files. The extension picks the processor; see Supported formats.
3. 3Add glossary terms and paste client rules so they bind the run.
4. 4Check the cost estimate on the task page, then run.
5. 5Review QA findings. Blocking findings stop delivery until fixed or force-shipped with a note.
6. 6Download the deliverable in the same format you uploaded.

34 file extensions have a dedicated processor. This list is generated from the processor registry, so it always matches what the pipeline accepts. Maximum upload size: 250 MB.

Every translated segment passes 31 deterministic checks. They are rule-based, so the same file always gives the same result. Each finding is either blocking (delivery stops) or a warning (logged for review).

When a task is blocked the deliverable is kept but not shipped. Fix and retry, or force-ship with a written reason; the reason is recorded in the audit log.

Rates below are read from the same source as the Pricing page. Each task shows a cost estimate before it runs, and prepaid balance is drawn down as tasks complete.

See the full Pricing page

1. 1Each delivered task can carry a signed certificate that records the file's hash and its QA findings.
2. 2Anyone who receives the file opens /verify and enters the certificate ID, or pastes the certificate JSON.
3. 3They then upload the file they received. Its fingerprint must match the certificate byte for byte.
4. 4Where the format allows, the deterministic QA checks are re-run on the file and must reproduce the signed findings.
5. 5The signature, file hash and revocation status are each shown as a separate check.

Share links for reviewers expire after 30 days by default and can be revoked at any time.

Verify a certificate

On macOS use Option (⌥); on Windows and Linux use Alt. Shortcuts are ignored while you type in a field.

For integrators. Authenticate with the session cookie from /api/v1/auth/login. Every path below is checked against the live router source in CI.

• POST/api/v1/auth/loginAuthenticate with your username OR your registered email, plus password. Returns a lab_session cookie (HttpOnly, 7-day TTL).

  200 { "token": "...", "github_login": "operator", "email": "op@example.com" }

  curl -X POST https://lab-forge.com.cn/api/v1/auth/login \
    -H "Content-Type: application/json" \
    -d '{"username":"operator","password":"your-password"}' \
    -c ./cookies.txt

• POST/api/v1/auth/registerRegister a new operator account. An invite code from your account manager is required unless the operator has opened signup.

  201 { "token": "...", "github_login": "newop", "email": "op@example.com" }

  curl -X POST https://lab-forge.com.cn/api/v1/auth/register \
    -H "Content-Type: application/json" \
    -d '{"username":"newop","password":"...","email":"op@example.com","registration_code":"..."}'

• GET/api/v1/auth/meVerify the current session. Returns operator info or 401.

  200 { "github_login": "operator", "email": "...", "token_version": 0, "is_admin": false }

  curl -X GET https://lab-forge.com.cn/api/v1/auth/me \
    -b ./cookies.txt

• GET/api/v1/projectsList all projects for the authenticated operator.

  200 [{ "id": "uuid", "client_name": "...", "source_lang": "EN", ... }]

  curl -X GET https://lab-forge.com.cn/api/v1/projects \
    -b ./cookies.txt

• POST/api/v1/projectsCreate a new project with client name, language pair, and rules profile.

  201 { "id": "uuid", "client_name": "Acme Corp", ... }

  curl -X POST https://lab-forge.com.cn/api/v1/projects \
    -H "Content-Type: application/json" \
    -b ./cookies.txt \
    -d '{"client_name":"Acme Corp","source_lang":"EN","target_langs":["NL"],"rules_profile_id":"example-ifu"}'

• PATCH/api/v1/projects/{project_id}Update project metadata or rules profile.

  200 { "id": "uuid", ... }

  curl -X PATCH https://lab-forge.com.cn/api/v1/projects/<id> \
    -H "Content-Type: application/json" \
    -b ./cookies.txt \
    -d '{"client_name":"Acme Corp (updated)","cost_cap_usd":5.0}'

• DELETE/api/v1/projects/{project_id}Delete a project and all associated files/tasks. Irreversible.

  204 No Content

  curl -X DELETE https://lab-forge.com.cn/api/v1/projects/<id> \
    -b ./cookies.txt

• POST/api/v1/documentsUpload a source document (bilingual RTF, XLIFF/CAT package, DOCX, SRT, etc. — routed by extension). project_id is a form field. Max 250 MB; 409 on a duplicate SHA-256 unless force=true.

  201 { "id": "uuid", "filename": "bilingual.rtf", "mode": "translate", ... }

  curl -X POST https://lab-forge.com.cn/api/v1/documents \
    -F "project_id=<project-uuid>" \
    -F "file=@bilingual.rtf" \
    -F "mode=translate" \
    -b ./cookies.txt

• POST/api/v1/glossaryAdd a glossary term pair (source → target) with category and flags. 409 if the exact source_term + target_lang pair already exists.

  201 { "id": "uuid", "source_term": "Low Speckle", ... }

  curl -X POST https://lab-forge.com.cn/api/v1/glossary \
    -H "Content-Type: application/json" \
    -b ./cookies.txt \
    -d '{"project_id":"<project-uuid>","source_lang":"EN","target_lang":"NL","source_term":"Low Speckle","target_term":"Lage speckle","category":"technical","case_sensitive":true}'

• POST/api/v1/projects/{project_id}/extract-rulesPaste raw client feedback; the extractor returns one-sentence imperative rules you can review before they bind a run.

  200 { "rules": [{ "imperative": "Product names must stay in English.", ... }] }

  curl -X POST https://lab-forge.com.cn/api/v1/projects/<id>/extract-rules \
    -H "Content-Type: application/json" \
    -b ./cookies.txt \
    -d '{"raw_text":"Product names must stay in English. Use NL decimal comma."}'

• POST/api/v1/tasksDispatch a translation task for an uploaded document. Returns immediately; follow progress by polling the task or streaming its events.

  201 { "id": "uuid", "status": "queued", ... }

  curl -X POST https://lab-forge.com.cn/api/v1/tasks \
    -H "Content-Type: application/json" \
    -b ./cookies.txt \
    -d '{"project_id":"<project-uuid>","document_id":"<doc-uuid>","target_lang":"NL"}'

• GET/api/v1/tasks/{task_id}Get task status, progress, and QA findings.

  200 { "id": "uuid", "status": "running", "qa_report": { "progress": { "latest": { "stage": "translate", "percent": 61.3, "current": 87, "total": 142 } } }, ... }

  curl -X GET https://lab-forge.com.cn/api/v1/tasks/<task-id> \
    -b ./cookies.txt

• GET/api/v1/tasks/{task_id}/eventsSSE stream for real-time task progress events. Connect via EventSource for live updates.

  text/event-stream: data: {"type":"progress","payload":{"step":"translate","message":"…","percent":61.3}}

  curl -N https://lab-forge.com.cn/api/v1/tasks/<task-id>/events \
    -b ./cookies.txt

• POST/api/v1/tasks/{task_id}/cancelCancel a running task. Terminal tasks cannot be cancelled.

  200 { "id": "uuid", "status": "cancelled", ... }  |  409 { "code": "task_not_cancellable" }

  curl -X POST https://lab-forge.com.cn/api/v1/tasks/<task-id>/cancel \
    -b ./cookies.txt

• POST/api/v1/tasks/{task_id}/confirmConfirm a completed task for delivery. Idempotent — calling twice returns 200.

  200 { "status": "confirmed" }

  curl -X POST https://lab-forge.com.cn/api/v1/tasks/<task-id>/confirm \
    -b ./cookies.txt

• POST/api/v1/tasks/{task_id}/force-shipForce-deliver a blocked task with an audit note.

  200 { "status": "force_shipped" }

  curl -X POST https://lab-forge.com.cn/api/v1/tasks/<task-id>/force-ship \
    -H "Content-Type: application/json" \
    -b ./cookies.txt \
    -d '{"reason":"False positive on gate #14 — client approved override."}'

• GET/api/v1/tasks/{task_id}/deliverableDownload the finished deliverable, returned in the shape the source arrived in (bilingual RTF, CAT package, DOCX, SRT, …).

  200 application/octet-stream (binary, Content-Disposition names the file)

  curl -X GET https://lab-forge.com.cn/api/v1/tasks/<task-id>/deliverable \
    -b ./cookies.txt \
    -OJ