Full Page OCR · ตัวอย่าง
สลิปโอนเงิน จากไฟล์ในเครื่อง
อัปโหลดไฟล์แบบ multipart ที่ POST /api/v3/upload ส่ง action และ model เป็น form field แทน JSON

- ส่งเอกสาร
ไฟล์ multipart (field file)- Endpoint
POST /api/v3/upload- action
transcribe- โมเดล
AksonOCR-1.0- ผลลัพธ์
- 1 หน้า · 1 เครดิต
- อ่านผลที่
pages[].markdown
Request
สคริปต์ครบตั้งแต่สร้างงาน poll สถานะ จนพิมพ์ Markdown ของทุกหน้า
import time, requestsAPI = "https://backend.aksonocr.com"headers = {"X-API-Key": "<YOUR_API_KEY>"}with open("slip.webp", "rb") as document:job_id = requests.post(f"{API}/api/v3/upload",headers=headers,files={"file": ("slip.webp", document, "image/webp")},data={"action": "transcribe", "model": "AksonOCR-1.0"},).json()["jobId"]while (status := requests.get(f"{API}/api/v3/ocr/status/{job_id}", headers=headers).json()["status"]) not in {"completed", "failed", "cancelled"}:time.sleep(2)if status != "completed":raise RuntimeError(f"OCR job {job_id} ended as {status}")result = requests.get(f"{API}/api/v3/ocr/result/{job_id}", headers=headers).json()for page in result["pages"]:print(page["markdown"])
คำตอบตอนสร้างงาน
HTTP 202 พร้อม jobId — งานยังไม่เสร็จ ต้อง poll GET /api/v3/ocr/status/{jobId} จนได้ completed
json
{"jobId": "fa82ff19-2207-45ee-9517-cb0714c91d5d","status": "pending","action": "transcribe","mode": "normal","model": "AksonOCR-1.0","createdAt": "2026-11-17T10:23:45.399Z"}
ผลลัพธ์
GET /api/v3/ocr/result/{jobId} — ผลจริงจากเอกสารด้านบน (ย่อ markdown ไว้ ฉบับเต็มอยู่ด้านล่าง)
json
{"jobId": "fa82ff19-2207-45ee-9517-cb0714c91d5d","action": "transcribe","model": "AksonOCR-1.0","pages": [{"index": 0,"markdown": "# โอนเงินสำเร็จ\n26 ม.ค. 65 05:10 น.\n…","confidence": 100}],"confidence": 100,"resultUrl": "https://storage.googleapis.com/…","resultUrlExpiresAt": "2026-11-17T11:23:54.692Z","usage": {"pages_processed": 1,"credits_used": 1},"totalPages": 1,"hasMore": false,"pageOffset": 0,"pageLimit": 1}
pages[0].markdown ฉบับเต็ม
markdown
# โอนเงินสำเร็จ26 ม.ค. 65 05:10 น.**นายกสิกร รักไทย**ธ.กสิกรไทยxxx-x-x8888-x**นายกสิกร รักไทย**ธ.กสิกรไทย888-8-8888-8**เลขที่รายการ:** 123456789012345678**จำนวน:** 888.00 บาท**ค่าธรรมเนียม:** 0.00 บาทverified by K+
รันเอกสารเดิมซ้ำ ข้อความจะเหมือนเดิม แต่การจัดรูปแบบ Markdown เช่น ตัวหนา หัวข้อ หรือเส้นคั่น --- อาจต่างกันเล็กน้อย อย่า parse ผลด้วยการจับรูปแบบ Markdown ตายตัว ถ้าต้องการค่าเป็นฟิลด์ใช้ Key Extraction
ข้อควรรู้
- ระบุ content type ของไฟล์ไว้เสมอ (;type=image/webp ใน curl หรือ tuple ตัวที่สามใน Python) บางเครื่องส่ง .webp เป็น application/octet-stream แล้วได้ 400
- รับเฉพาะ image/* และ application/pdf
- ชื่อผู้โอน ยอดเงิน และเลขที่รายการออกมาเป็นตัวหนา — ถ้าต้องการเป็นฟิลด์ JSON ใช้ Key Extraction แทน