Key Extraction · API v3

คู่มือ

รวมแนวทางใช้ Key Extraction v3 ในงานจริง — จาก schema และ bounding box ไปจนถึง polling และ overlay

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 มุมบนซ้าย

อย่าแปลงพิกัดเองจากพิกเซลของ v1 — v3 คืนค่า 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 วินาที