API Reference
OCR v2 — Sync
ส่งเอกสารแล้วรับ markdown ในคำตอบเดียว สูงสุด 50 หน้าต่อ request และไฟล์ 10 MB งานยาวหรือ webhook ให้ใช้ OCR v3
OCR จาก URL / JSON
POST
https://backend.aksonocr.com/api/v2/ocrimport requestsr = 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"])
| ฟิลด์ | ชนิด | จำเป็น | รายละเอียด |
|---|---|---|---|
model | string | ใช่ | AksonOCR-1.0 | AksonOCR-preview | AksonOCR-handwriting |
document.type | string | ใช่ | image_url | document_url |
document.image_url | string | ตาม type | URL รูปที่เข้าถึงได้จากอินเทอร์เน็ต (JPEG, PNG, WebP, GIF ≤ 10 MB) หรือ data URI base64 |
document.document_url | string | ตาม type | PDF ผ่าน URL หรือ data URI base64 เช่น data:application/pdf;base64,... |
pages | integer[] | ไม่ | หน้าที่ต้องการ (0-indexed) สำหรับ PDF |
tokenConfidence | boolean | ไม่ | เพิ่ม pages[].tokens — บางโมเดลคืนอาร์เรย์ว่าง |
OCR จากอัปโหลดไฟล์
POST
https://backend.aksonocr.com/api/v2/uploadmultipart/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-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 — ดู ข้อผิดพลาด