คู่มือ
รวมแนวทางใช้ Key Extract v3 ในงานจริง — จาก schema และ bounding box ไปจนถึง webhook และ overlay
เลือกโหมดหลักฐาน
bbox เป็นค่าเริ่มต้น หรือ none ถ้าไม่ต้องการพิกัด
ตั้งค่า request
schema, template, หน้า PDF, webhook, 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 ด้วยคีย์เดิม ระบบคืนงานเดิมแทนการสร้างคิวซ้ำ
Webhooks
ส่ง webhook_id ที่ลงทะเบียนไว้แล้ว — v3 ไม่รับ URL arbitrary ในตัวงาน เพื่อกัน SSRF เมื่องานจบ ค่อย GET /jobs/:id/result