API Reference

OCR v2 — Sync

ส่งเอกสารแล้วรับ markdown ในคำตอบเดียว สูงสุด 50 หน้าต่อ request และไฟล์ 10 MB งานยาวหรือ webhook ให้ใช้ OCR v3

OCR จาก URL / JSON

POSThttps://backend.aksonocr.com/api/v2/ocr
import requests
r = requests.post(
"https://backend.aksonocr.com/api/v2/ocr",
headers={"X-API-Key": "<YOUR_API_KEY>"},
json={
"model": "AksonOCR-1.0",
"document": {"type": "image_url", "image_url": "https://example.com/page.jpg"},
},
)
r.raise_for_status()
print(r.json()["pages"][0]["markdown"])
ฟิลด์ชนิดจำเป็นรายละเอียด
modelstringใช่AksonOCR-1.0 | AksonOCR-preview | AksonOCR-handwriting
document.typestringใช่image_url | document_url
document.image_urlstringตาม typeURL รูปที่เข้าถึงได้จากอินเทอร์เน็ต (JPEG, PNG, WebP, GIF ≤ 10 MB) หรือ data URI base64
document.document_urlstringตาม typePDF ผ่าน URL หรือ data URI base64 เช่น data:application/pdf;base64,...
pagesinteger[]ไม่หน้าที่ต้องการ (0-indexed) สำหรับ PDF
tokenConfidencebooleanไม่เพิ่ม pages[].tokens — บางโมเดลคืนอาร์เรย์ว่าง

OCR จากอัปโหลดไฟล์

POSThttps://backend.aksonocr.com/api/v2/upload

multipart/form-data ฟิลด์ไฟล์ชื่อ fileพร้อม model

bash
curl -X POST 'https://backend.aksonocr.com/api/v2/upload' \
-H 'X-API-Key: <YOUR_API_KEY>' \
-F 'model=AksonOCR-1.0'

Response 201

ผลจริงจากสลิปตัวอย่าง (ตัด markdown ให้สั้น) — ทั้ง /ocr และ /upload คืนรูปเดียวกัน

json
{
"model": "AksonOCR-1.0",
"pages": [
{
"index": 0,
"markdown": "โอนเงินสำเร็จ\n26 ม.ค. 65 05:10 น.\nK+\n\nนายกสิกร รักไทย\n...",
"confidence": 100
}
],
"confidence": 100,
"usage": { "pages_processed": 1 }
}
ฟิลด์รายละเอียด
modelโมเดลที่ประมวลผล
pages[].indexเลขหน้าเริ่มที่ 0
pages[].markdownข้อความของหน้านั้น
pages[].confidenceความมั่นใจของหน้า 0–100
pages[].tokensมีเมื่อส่ง tokenConfidence: true
confidenceค่าเฉลี่ยทุกหน้า 0–100
usage.pages_processedจำนวนหน้าที่คิดเครดิต — เครดิตที่ใช้ = หน้า × เครดิต/หน้าของโมเดล

Errors

HTTPเมื่อไหร่
400ฟิลด์ผิด เช่น ไม่ส่ง model หรือชนิดไฟล์ไม่รองรับ
401ไม่มีหรือ API key ไม่ถูกต้อง
402เครดิตไม่พอ
429เกิน RPM หรือโควตาต่อวัน
504ประมวลผลไม่ทันในเวลาของ request sync — ใช้ OCR v3
Body เป็น { "success": false, "error": { "code": "HTTP_ERROR", "message": "..." } } แยกด้วย HTTP status และอ่าน error.message — ดู ข้อผิดพลาด