Key Extraction · API v3
ระดับการใช้งาน
Key Extract v3 ไม่ให้เลือกโมเดลสาธารณะ — เลือกแค่ระดับหลักฐานที่ต้องการคืน และว่าจะส่ง schema ในงานหรือใช้เทมเพลต
| output.evidence | เหมาะกับ | ผลลัพธ์ |
|---|---|---|
bbox | overlay ใน UI, ตรวจทาน, audit ว่าค่ามาจากจุดไหนบนหน้า — ค่าเริ่มต้นที่แนะนำ | field_metadata.regions มี bbox แบบ xyxy normalize 0–1 และข้อความต้นทาง |
none | ต้องการแค่ JSON ค่าฟิลด์ ไม่ต้องวาดกรอบ | ยังมี status และ confidence แต่ regions เป็นอาร์เรย์ว่าง |
Schema ในงาน vs เทมเพลต
| วิธี | ใช้เมื่อ |
|---|---|
data_schema | prototype, เอกสารรูปแบบใหม่, หรือ schema ที่ยังเปลี่ยนบ่อย |
template | เอกสารซ้ำๆ ที่ล็อก schema แล้ว — งานจะ snapshot เวอร์ชันตอนรับคำขอ |
ส่งได้อย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้ง
template และ data_schema ในงานเดียวกัน และห้าม merge schema ทับเทมเพลตตอนเรียกreview_threshold
ค่า 0–1 (ค่าเริ่มต้น 0.8 จากเทมเพลตหรือโปรเจกต์) ใช้จัดคิวตรวจทาน ไม่ได้แก้ค่าที่ดึงได้ ฟิลด์ที่ต่ำกว่าเกณฑ์ไปอยู่ใน validation.below_threshold และตั้ง needs_review: true
เครดิต
Key Extract v3 คิดตามหน้า
จำนวนหน้าที่ประมวลผลอยู่ใน
usage.pages_processedดูเครดิตต่อหน้าของโมเดล OCR อื่นที่ เครดิต และลิมิตไฟล์ที่ Rate Limitsเมื่อไหร่ไม่ใช้ v3
ถ้าต้องการแค่ข้อความทั้งหน้าโดยไม่ต้อง JSON ตามคีย์ ให้ใช้ OCR v2 หรือ OCR v3 transcribeถ้าต้องการ URL สาธารณะแบบ sync โดยไม่ต้องอัปโหลดไฟล์ก่อน ใช้ Key Extraction v1 (bbox มีเฉพาะ aksonocr1.5)