API Reference

OCR v2 — Sync

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

OCR จาก URL / JSON

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

curl -X POST 'https://backend.aksonocr.com/api/v2/ocr' \
  -H 'X-API-Key: <YOUR_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "AksonOCR-preview",
    "tokenConfidence": true,
    "document": {
      "type": "image_url",
      "image_url": "https://example.com/page.jpg"
    }
  }'

ฟิลด์	ชนิด	จำเป็น	รายละเอียด
`model`	string	ใช่	AksonOCR-preview \| AksonOCR-1.0 \| AksonOCR-handwriting
`document.type`	string	ใช่	image_url \| document_url \| base64
`document.image_url`	string	ตาม type	HTTPS สาธารณะ
`document.document_url`	string	ตาม type	PDF ผ่าน URL
`document.base64`	string	ตาม type	ไฟล์เข้ารหัส base64
`pages`	integer[]	ไม่	หน้าที่ต้องการ (0-indexed) สำหรับ PDF
`tokenConfidence`	boolean	ไม่	คืนความมั่นใจระดับโทเคน

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 '[email protected]' \
  -F 'model=AksonOCR-preview'

Response 200

json

{
  "model": "AksonOCR-preview",
  "pages": [
    { "index": 0, "markdown": "# ใบเสร็จ\n..." }
  ],
  "usage": { "pages_processed": 1, "credits_used": 0.5 }
}

ฟิลด์	รายละเอียด
`model`	โมเดลที่ประมวลผล
`pages[].index`	เลขหน้าเริ่มที่ 0
`pages[].markdown`	ข้อความของหน้านั้น
`usage.pages_processed`	จำนวนหน้าที่คิดเครดิต

Errors

HTTP	code
400	`invalid_request`
401	`unauthorized`
402	`insufficient_credits`
429	`rate_limited`

Body รูป { "error": "...", "code": "..." }

Authentication

OCR v3 — Async