คู่มือ
รวมแนวทางใช้ Key Extraction v3 ในงานจริง — จาก schema และ bounding box ไปจนถึง polling และ overlay
เลือกโหมดหลักฐาน
bbox เป็นค่าเริ่มต้น หรือ none ถ้าไม่ต้องการพิกัด
ตั้งค่า request
schema, template, หน้า PDF, retention
อ่านผลลัพธ์
data, field_metadata, confidence และ bbox xyxy
สูตรสำเร็จ
ใบแจ้งหนี้, overlay bbox, หลายหน้า
REST ทั้งเส้นทาง
files → jobs → poll → result
ย้ายเวอร์ชัน
จาก Key Extraction v1 (sync) มา v3
Schema และตาราง
รากต้องเป็น type: object ฟิลด์สเกลาร์ใช้ string / number / integer / boolean อาร์เรย์ของ object คือตาราง — ส่งกี่ตารางก็ได้โดยไม่ต้องมี listConfig
Bounding box
ค่าเริ่มต้นคือ output.evidence: "bbox" แต่ละฟิลด์ใน field_metadata มี regions[] เป็นกรอบบนหน้าต้นฉบับ รูปแบบเดียว: [x_min, y_min, x_max, y_max] normalize 0–1 มุมบนซ้าย
เลือกหน้า PDF
ใน inputs[] ใส่ pages เป็นเลขหน้า 1-based ของไฟล์นั้น เช่น { "file_id": "...", "pages": [1, 3, 4] }ห้ามใส่ pages กับไฟล์รูป
Idempotency
การสร้างงานต้องมี header Idempotency-Key เมื่อ retry ด้วยคีย์เดิม ระบบคืนงานเดิมแทนการสร้างคิวซ้ำ
Polling (ยังไม่มี webhook)
Key Extraction v3 ยังไม่ส่ง webhook — ฟิลด์ webhook_id รับไว้แต่ยังไม่มีผล ให้ poll GET /jobs/:id ทุก 2–5 วินาทีจนสถานะเป็น completed, failed, cancelled หรือ expired แล้วค่อย GET /jobs/:id/resultหน้าเดียวมักเสร็จภายใน 5–10 วินาที