OCR.chat API

ເບິ່ງ​ລວມ

The OCR.chat API is a small REST interface. You POST a file and get back a job with the recognized text and a per-page breakdown (text, bounding boxes, confidence). Jobs of 5 pages or fewer return inline; larger jobs return immediately with a pending status that you poll until done.

• Base URL: https://ocr.chat
• Formats in: PNG, JPG, WEBP, GIF, BMP, TIFF, and multi-page PDF
• Formats out: txt, md, docx, pdf, csv, json
• Engines: cpu (fast, printed docs) and vlm (premium AI, handwriting, complex layout, math)

ການ​ផ្ទៀង​ផ្ទាត់​ຄວາມ​ຖືກຕ້ອງ

Authenticate with your API token (find it on your account page) as a Bearer header:

Authorization: Bearer YOUR_API_TOKEN

You can also pass ?api_token=… as a query parameter. Usage is metered against your account's page balance.

ສົ່ງ​ເອກະສານ

POST /api/v1/ocr/, multipart form upload.

curl -X POST https://ocr.chat/api/v1/ocr/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@invoice.pdf" \
  -F "tier=vlm" \
  -F "language=auto"

Returns the job. For ≤5-page files it is already done with the text; larger files come back pending/processing, poll the status endpoint.

{
  "uuid": "9f2c1b7e4a...",
  "status": "done",
  "tier": "vlm",
  "language": "auto",
  "page_count": 1,
  "mean_confidence": 0.98,
  "text": "INVOICE\nAcme Corp\nTotal: 215.00 USD",
  "markdown": "# INVOICE\n\n**Acme Corp** ...",
  "pages": [ { "index": 0, "text": "...", "blocks": [ { "text": "...", "bbox": [x0,y0,x1,y1], "confidence": 0.98 } ] } ]
}

ຮັບ​ຜົນ​ໄດ້

GET /api/v1/ocr/<uuid>/, poll until status is done or failed.

curl https://ocr.chat/api/v1/ocr/9f2c1b7e4a.../ \
  -H "Authorization: Bearer YOUR_API_TOKEN"

ດາວໂຫລດ​ຮູບແບບ

GET /api/v1/ocr/<uuid>/download/?format=md, export the result. format is one of txt, md, docx, pdf, csv, json.

curl -L "https://ocr.chat/api/v1/ocr/9f2c1b7e4a.../download/?format=docx" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o result.docx

ສົນທະນາ​ກັບ​ເອກະສານ

ຖາມ​ຄໍາຖາມ​ກ່ຽວກັບ​ວຽກ​ທີ່​ໄດ້​ເຮັດ​ແລ້ວ. ຄໍາຕອບ​ແມ່ນ​ອີງ​ໃສ່​ຂໍ້ຄວາມ​ທີ່​ໄດ້​ຖອດ​ອອກ​ມາ ແລະ ຖອດ​ບົດ​ຄວາມ​ທີ່​ມາ​ຈາກ​ຫນ້າ​ແຫຼ່ງ. ຕ້ອງການ​ບັນຊີ​ໂຕກັ່ນ - ຄຸນສົມບັດ​ການ​ສົນທະນາ​ແມ່ນ​ບັນຊີ​ທີ່​ໄດ້​ຮັບ​ການ​ເຂົ້າ​ເຖິງ.

POST /api/v1/chat/<uuid>/, JSON body {"message": "your question"}.

curl -X POST https://ocr.chat/api/v1/chat/9f2c1b7e4a.../ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "What is the invoice total and due date?"}'

ສົ່ງຄືນ​ຂໍ້ຄວາມ​ຂອງ​ຜູ້ຊ່ວຍ​ພ້ອມ​ດ້ວຍ​ຄຳ​ຕອບ ແລະ ລາຍ​ຊື່​ຂອງ​ໜ້າ​ທີ່​ອ້າງອີງ:

{"conversation": "a1b2…", "message": {
   "role": "assistant",
   "content": "The total is $42, due on March 3 (p. 1).",
   "citations": [{"page": 1, "snippet": "The invoice total is $42…"}]
}}

GET /api/v1/chat/<uuid>/history/, ເອົາ​ການ​ສົນທະນາ​ເຕັມ​ມາ​ໃຊ້​ໃນ​ວຽກ​ໜຶ່ງ

ຕົວຢ່າງ​ຂອງ​កូដ

• Python
• Node.js
• cURL

import requests, time

API = "https://ocr.chat/api/v1/ocr/"
H = {"Authorization": "Bearer YOUR_API_TOKEN"}

# Submit
with open("invoice.pdf", "rb") as f:
    job = requests.post(API, headers=H,
        files={"file": f}, data={"tier": "vlm"}).json()

# Poll until done
while job["status"] in ("pending", "processing"):
    time.sleep(2)
    job = requests.get(API + job["uuid"] + "/", headers=H).json()

print(job["markdown"])

# Download as DOCX
r = requests.get(API + job["uuid"] + "/download/",
                 headers=H, params={"format": "docx"})
open("result.docx", "wb").write(r.content)

import fs from "fs";

const API = "https://ocr.chat/api/v1/ocr/";
const H = { Authorization: "Bearer YOUR_API_TOKEN" };

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("invoice.pdf")]), "invoice.pdf");
form.append("tier", "vlm");

let job = await (await fetch(API, { method: "POST", headers: H, body: form })).json();

while (["pending", "processing"].includes(job.status)) {
  await new Promise(r => setTimeout(r, 2000));
  job = await (await fetch(API + job.uuid + "/", { headers: H })).json();
}
console.log(job.markdown);

# 1. Submit
curl -X POST https://ocr.chat/api/v1/ocr/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@invoice.pdf" -F "tier=vlm"

# 2. Poll  (use the uuid from step 1)
curl https://ocr.chat/api/v1/ocr/UUID/ \
  -H "Authorization: Bearer YOUR_API_TOKEN"

# 3. Download
curl -L "https://ocr.chat/api/v1/ocr/UUID/download/?format=md" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o result.md

​ប៉ារ៉ាម៉ែត្រ

ຂໍ້ຜິດພາດ & ຈໍາກັດ

Each page processed costs credits (1/page on the fast tier, more on premium). Paid plans raise per-file page caps and add priority. See pricing.

ຄໍາຖາມທີ່ຖາມເລື້ອຍໆ