คำถามที่พบบ่อยและการแก้ไขปัญหา

บัญชีและการยืนยันตัวตน

ฉันลืมรหัสผ่าน ทำอย่างไร?

คลิก Forgot password บนหน้าล็อกอิน แล้วกรอก Email ที่ลงทะเบียนไว้ ระบบจะส่งลิงก์รีเซ็ตรหัสผ่านไปยัง Email ของคุณ ลิงก์มีอายุการใช้งานจำกัด หากหมดอายุให้ขอลิงก์ใหม่ได้ทันที หากไม่ได้รับ Email ให้ตรวจสอบโฟลเดอร์ Spam หรือ Junk ก่อน

ฉันสมัครด้วย Google แต่ล็อกอินด้วย Email ไม่ได้

บัญชีที่สร้างผ่าน Google OAuth จะใช้ Google เป็นช่องทางล็อกอินเท่านั้น คุณไม่สามารถล็อกอินด้วย Email + รหัสผ่านสำหรับบัญชีนั้นได้ ให้คลิก Sign in with Google แทน หากต้องการบัญชีแบบ Email + รหัสผ่านให้สมัครใหม่ด้วย Email

ฉันได้รับข้อความ "Unauthorized" ทุกครั้งที่ล็อกอิน

สาเหตุที่พบบ่อย:

• Token หมดอายุ — ล็อกออกและล็อกอินใหม่
• Browser บล็อก Cookie — ตรวจสอบว่าไม่ได้บล็อก Cookie จากโดเมนของแพลตฟอร์ม
• บัญชีถูกระงับ — ติดต่อ Admin ขององค์กรหรือ Support

ฉันอยู่ในหลายองค์กร จะสลับองค์กรได้อย่างไร?

คลิกที่ชื่อองค์กรปัจจุบันที่ด้านบนของ Sidebar แล้วเลือกองค์กรที่ต้องการจากรายการ หากไม่เห็นองค์กรที่ต้องการ ให้ตรวจสอบกับ Admin ว่าได้รับเชิญและยืนยันสมาชิกภาพแล้วหรือยัง

อัปโหลดและประมวลผล

ไฟล์ประเภทใดที่รองรับ?

ระบบรองรับไฟล์ประเภท: PDF, PNG, JPEG, GIF, WebP ไฟล์ประเภทอื่นจะถูกปฏิเสธทันทีเมื่ออัปโหลด

ขนาดไฟล์สูงสุดเท่าไร?

ขนาดไฟล์ต่อไฟล์ขึ้นอยู่กับแพ็กเกจขององค์กร โดยทั่วไปอยู่ที่ไม่เกิน 20 MB ต่อไฟล์ สำหรับเอกสารขนาดใหญ่กว่านี้ ให้แยกเป็นหลายไฟล์หรือลดขนาด PDF ก่อนอัปโหลด

ทำไมผลการสกัดข้อมูลจึงผิดพลาดหรือไม่ครบถ้วน?

ปัญหานี้มักมาจากสาเหตุต่อไปนี้:

• คำสั่ง Template ไม่ชัดเจน — ตรวจสอบ Prompt ใน Template ว่าระบุชื่อฟิลด์ รูปแบบที่คาดหวัง และกรณีขอบ (เช่น ค่าที่ไม่มีในเอกสาร) อย่างชัดเจนหรือไม่
• เอกสารมีคุณภาพต่ำ — รูปถ่ายที่มืด เบลอ หรือบิดเบี้ยวจะลดความแม่นยำของ AI อย่างมีนัยสำคัญ ใช้รูปที่มีแสงเพียงพอและถ่ายตรง
• โมเดล AI ไม่เหมาะกับประเภทเอกสาร — ลองเปลี่ยนโมเดลใน Template แล้วทดสอบใหม่ ดูคู่มือการเลือกโมเดลสำหรับข้อมูลเพิ่มเติม
• ภาษาในเอกสารไม่ตรงกับคำสั่ง — หากเอกสารเป็นภาษาไทยแต่คำสั่งเขียนเป็นอังกฤษ ลองเพิ่มคำสั่งเป็นภาษาไทยหรือระบุว่าเอกสารเป็นภาษาไทย

การประมวลผลใช้เวลานานเท่าไร?

โดยปกติการประมวลผลเอกสารใช้เวลา 5–30 วินาที ขึ้นอยู่กับขนาดและความซับซ้อนของเอกสาร รวมถึงโมเดล AI ที่เลือก Gemini Flash และ GPT-4o-mini มักเร็วกว่าโมเดลพรีเมียม หากการประมวลผลค้างนานกว่า 5 นาที ให้ตรวจสอบสถานะใน Processing History

ทำไมสถานะเอกสารแสดงว่า "Failed"?

สาเหตุที่พบบ่อย:

• เครดิตไม่เพียงพอ — ระบบตรวจสอบยอดเครดิตก่อนประมวลผล หากเครดิตไม่พอจะปฏิเสธทันที
• Template ไม่ได้กำหนด AI Model — ตรวจสอบว่า Template ที่ใช้มีการกำหนดโมเดล AI แล้ว
• ผู้ให้บริการ AI ไม่พร้อมใช้งาน — หากผู้ให้บริการมีปัญหา ลองเปลี่ยนโมเดลใน Template เป็นผู้ให้บริการรายอื่น
• ไฟล์เสียหาย — PDF หรือรูปภาพที่เสียหายอาจทำให้ประมวลผลไม่ได้ ลองเปิดไฟล์บนเครื่องก่อนเพื่อตรวจสอบ

Batch ประมวลผลได้สูงสุดกี่ไฟล์?

Batch หนึ่งรองรับสูงสุด 50 ไฟล์ ไฟล์ในแต่ละ Batch จะถูกประมวลผลพร้อมกัน คุณสามารถติดตามความคืบหน้าแบบเรียลไทม์จากหน้า Batch detail

Ocriva รองรับเอกสารสแกนและ PDF ดิจิทัลต่างกันอย่างไร?

ทั้งสองแบบใช้งานได้ โดยความแตกต่างสำคัญอยู่ที่คุณภาพของข้อมูลนำเข้า:

• เอกสารสแกน — Ocriva ส่งรูปภาพโดยตรงไปยัง AI vision model เพื่อให้การสกัดข้อมูลแม่นยำ รูปสแกนควรมีความละเอียดอย่างน้อย 150 DPI การสแกนที่ความละเอียดต่ำกว่านี้อาจทำให้ AI อ่านตัวอักษรผิดหรือข้ามฟิลด์ไป นอกจากนี้ให้แน่ใจว่าเอกสารไม่ได้หมุนหรือเอียงมาก
• PDF ดิจิทัล (PDF ที่สร้างจากซอฟต์แวร์ ไม่ใช่สแกน) — มีข้อความที่เลือกได้ ซึ่ง AI สามารถอ่านได้แม่นยำกว่าและใช้ Token น้อยกว่า หากเป็นไปได้ควรใช้ PDF ดิจิทัลแทนการสแกน

รองรับเอกสารหลายภาษาได้หรือไม่?

ได้ โมเดล AI ที่ใช้งานอยู่ (GPT-4o, Gemini, Claude) มีความสามารถด้านหลายภาษา ภาษาไทยและภาษาอังกฤษเป็นภาษาที่ได้รับการทดสอบและรองรับดีที่สุดบนแพลตฟอร์ม ภาษาอาหรับ จีน ญี่ปุ่น และภาษาหลักอื่น ๆ ก็สามารถใช้งานได้ในส่วนใหญ่

เพื่อเพิ่มความแม่นยำสำหรับภาษาเฉพาะ ให้เพิ่มคำสั่งระบุภาษาใน System Prompt ของ Template ตัวอย่างเช่น: "เอกสารนี้เขียนเป็นภาษาไทย กรุณาสกัดข้อมูลทุกฟิลด์ในภาษาต้นฉบับ"

ฉันจะ Export ผลลัพธ์ Batch ได้อย่างไร?

เมื่อ Batch ประมวลผลเสร็จสิ้น ให้เปิด Batch จากหน้า Documents แล้วคลิก Export มีสองรูปแบบให้เลือก:

• JSON — ไฟล์รวมไฟล์เดียวที่ประกอบด้วยผลลัพธ์การสกัดข้อมูลแบบ Structured ของทุกเอกสาร
• CSV — รวมทุกแถวเป็น Spreadsheet แบบแบน เหมาะสำหรับนำเข้า Excel หรือฐานข้อมูล

ปุ่ม Export จะถูกปิดใช้งานตราบใดที่ยังมีรายการใน Batch ที่กำลังประมวลผลอยู่ รอให้ทุกรายการมีสถานะ Completed หรือ Failed ก่อนจึงจะ Export ได้

ดูรายละเอียดการจัดการ Batch และโครงสร้างผลลัพธ์เพิ่มเติมได้ที่ Batch Processing

เทมเพลต

Template คืออะไร และทำไมต้องใช้?

Template บอกให้ Ocriva รู้ว่าจะสกัดข้อมูลอะไรจากเอกสารของคุณและจะจัดรูปแบบผลลัพธ์อย่างไร โดยกำหนด:

• ฟิลด์การสกัด (เช่น เลขที่ใบแจ้งหนี้ วันที่ ชื่อผู้ขาย ยอดรวม)
• โมเดล AI ที่ใช้ในการสกัดข้อมูล
• รูปแบบผลลัพธ์ (JSON, CSV, PDF ฯลฯ)
• System Prompt และ RAG Data Files ที่เป็นตัวเลือกเสริมสำหรับบริบทเพิ่มเติม

การอัปโหลดทุกครั้งต้องเชื่อมโยงกับ Template หากไม่มี Template ระบบจะไม่รู้ว่าต้องหาข้อมูลอะไรในเอกสารของคุณ

ฉันจะปรับปรุงความแม่นยำในการสกัดข้อมูลได้อย่างไร?

ปัจจัยหลายอย่างส่งผลต่อความแม่นยำของ AI ในการสกัดข้อมูล:

• ตั้งชื่อฟิลด์ให้ชัดเจน ชื่อฟิลด์ invoice_total_amount_thb ให้บริบทแก่โมเดลได้ดีกว่าชื่อแค่ total
• เขียน System Prompt ที่ชัดเจน ใช้ System Prompt อธิบายประเภทเอกสารและกฎการสกัดข้อมูลที่เฉพาะกับกรณีใช้งานของคุณ
• เพิ่ม RAG Data Files หากเอกสารมีรหัสภายใน รายการสินค้า หรือคำศัพท์เฉพาะ ให้อัปโหลดไฟล์อ้างอิงเป็น RAG Data Files เพื่อให้โมเดลใช้ค้นหา
• เลือกโมเดล AI ที่เหมาะสม สำหรับเอกสารซับซ้อนหรือคุณภาพต่ำ ให้ใช้โมเดลที่มีความสามารถสูงกว่า (GPT-4o, Claude) สำหรับเอกสารที่เป็นระเบียบและมีโครงสร้างชัดเจน โมเดลเบา (GPT-4o-mini, Gemini Flash) มักเพียงพอและถูกกว่า
• ใช้รูปภาพความละเอียดสูง การสแกนที่เบลอหรือคอนทราสต์ต่ำจะลดความแม่นยำการสกัดข้อมูลไม่ว่าจะใช้โมเดลใด

ฉันสามารถใช้โมเดล AI ต่างกันสำหรับแต่ละ Template ได้หรือไม่?

ได้ แต่ละ Template มีการตั้งค่าโมเดล AI เป็นของตัวเอง คุณสามารถมี Template หนึ่งที่ใช้ GPT-4o สำหรับเอกสารการเงินสำคัญ และอีก Template หนึ่งที่ใช้ Gemini Flash สำหรับใบเสร็จทั่วไป — ทั้งหมดในโปรเจกต์เดียวกัน

ผู้ให้บริการที่รองรับในปัจจุบันได้แก่ OpenAI, Google Gemini, Anthropic Claude, DeepSeek, Qwen และ Kimi รายการโมเดลที่ใช้งานได้สะท้อนถึงข้อมูลประจำตัวของผู้ให้บริการที่กำหนดค่าไว้ในอินสแตนซ์แพลตฟอร์มของคุณ

ฉันจะทดสอบ Template ก่อนใช้งานจริงได้อย่างไร?

เปิด Template ใน Templates → Edit แล้วคลิกปุ่ม Test บน Toolbar คุณสามารถอัปโหลดเอกสารตัวอย่างและแพลตฟอร์มจะรันการสกัดข้อมูลสดโดยใช้การกำหนดค่า Template ปัจจุบัน ผลลัพธ์จะแสดงให้เห็นทันทีเพื่อให้คุณเปรียบเทียบค่าที่สกัดได้กับเอกสารต้นฉบับแบบเคียงข้างกัน

ใช้การทดสอบเพื่อ:

1. ตรวจสอบว่าทุกฟิลด์ได้รับการกรอกข้อมูล
2. ระบุฟิลด์ที่มีค่าความมั่นใจต่ำหรือไม่ถูกต้อง
3. ปรับชื่อฟิลด์ System Prompt หรือ RAG Data Files แล้วทดสอบซ้ำจนความแม่นยำเป็นที่น่าพอใจ

โมเดล AI ที่มีให้ใช้มีอะไรบ้าง และแตกต่างกันอย่างไร?

โมเดลที่ใช้งานได้ขึ้นอยู่กับข้อมูลประจำตัวของผู้ให้บริการที่กำหนดค่าไว้ในอินสแตนซ์แพลตฟอร์มของคุณ ตัวเลือกทั่วไปและข้อดีข้อเสียตามแบบฉบับ:

หากไม่แน่ใจว่าจะเริ่มต้นด้วยโมเดลใด GPT-4o-mini มีความสมดุลที่ดีระหว่างความแม่นยำและต้นทุนสำหรับเอกสารส่วนใหญ่ อัปเกรดเป็น GPT-4o สำหรับเอกสารการเงิน กฎหมาย หรือเอกสารสำคัญอื่น ๆ ที่ความแม่นยำสูงกว่าคุ้มค่ากับต้นทุนเพิ่มเติม

ฉันสร้าง Template แล้ว แต่ไม่เห็นใน Dropdown ตอนอัปโหลด

Template ต้องสังกัด Project เดียวกับที่คุณกำลังอัปโหลดไฟล์ ตรวจสอบว่า Template ถูกสร้างภายใต้ Project ที่ถูกต้อง และคุณมีสิทธิ์เข้าถึง Project นั้น

ฉันอัปเดต Template แล้ว มีผลกับเอกสารที่ประมวลผลไปแล้วหรือไม่?

ไม่มีผล การเปลี่ยนแปลง Template จะมีผลกับการประมวลผลที่เกิดขึ้น หลังจาก บันทึกการเปลี่ยนแปลงเท่านั้น เอกสารที่ประมวลผลไปแล้วจะยังแสดงผลลัพธ์เดิม หากต้องการผลลัพธ์ใหม่ ต้องประมวลผลเอกสารนั้นใหม่อีกครั้ง

Data Files (RAG) คืออะไร และเมื่อไรควรใช้?

Data Files คือเอกสารอ้างอิงที่คุณแนบกับ Template เพื่อให้ AI มีบริบทเพิ่มเติมขณะสกัดข้อมูล เหมาะสำหรับกรณีที่:

• เอกสารของคุณมีรหัสหรือคำย่อเฉพาะองค์กรที่ AI ไม่รู้จัก
• คุณต้องการให้ AI อ้างอิงตารางราคา รายการสินค้า หรือข้อมูลอ้างอิงเพิ่มเติม
• Template ต้องการ Lookup ข้อมูลจากฐานความรู้ภายใน

Template ฉันถึงขีดจำกัดแล้ว จะทำอย่างไร?

แต่ละแพ็กเกจมีขีดจำกัดจำนวน Template ต่อ Project หากถึงขีดจำกัด (maxTemplates) คุณต้อง:

1. ลบ Template ที่ไม่ใช้งานแล้ว
2. อัปเกรดแพ็กเกจขององค์กรเพื่อรับขีดจำกัดที่สูงขึ้น

เครดิตและการเรียกเก็บเงิน

เครดิตถูกหักเมื่อไร?

เครดิตถูกหัก ต่อไฟล์ที่ประมวลผล ทันทีเมื่อการประมวลผลเริ่มต้น ไม่ใช่ต่อ Batch ระบบตรวจสอบยอดเครดิตก่อนเริ่มประมวลผลทุกครั้ง หากเครดิตไม่พอ ไฟล์จะถูกปฏิเสธทันทีโดยไม่เริ่มประมวลผล

ทำไมเครดิตของฉันหมดเร็วมาก?

ให้ตรวจสอบสิ่งต่อไปนี้:

• Processing History — ดูว่าไฟล์ใดถูกประมวลผลไปบ้างและใช้เครดิตเท่าไร
• โมเดล AI ที่ใช้ — โมเดลพรีเมียม (GPT-4o, Claude Sonnet) ใช้เครดิตมากกว่าโมเดลเบา (GPT-4o-mini, Gemini Flash) หลายเท่า
• การประมวลผลซ้ำ — ตรวจสอบว่ามีการประมวลผลไฟล์เดิมซ้ำโดยไม่ตั้งใจหรือไม่
• สมาชิกในทีม — เครดิตเป็นของทั้งองค์กร สมาชิกทุกคนใช้ Pool เดียวกัน

เครดิต Package หมดอายุหรือไม่?

เครดิต Package หมดอายุหลัง 30 วันนับจากวันชำระเงิน ส่วน เครดิต Top-up ไม่มีวันหมดอายุ เมื่อประมวลผลเอกสาร ระบบจะใช้เครดิต Package ก่อนเสมอ

ฉันชำระเงินแล้วแต่เครดิตยังไม่เพิ่ม

การเพิ่มเครดิตเกิดขึ้นหลังจาก Stripe ส่ง Webhook ยืนยันการชำระเงินมาถึงระบบ ซึ่งปกติใช้เวลาไม่เกิน 1–2 นาที หากรอนานกว่า 10 นาทีแล้วยังไม่เห็นเครดิตเพิ่ม:

1. ตรวจสอบว่า Session Checkout บน Stripe เสร็จสมบูรณ์แล้ว (ไม่ใช่แค่ถูกเปลี่ยนเส้นทางกลับ)
2. รีเฟรชหน้า Billing
3. หากยังไม่มีเครดิต ให้เปิด Support Ticket ประเภท Billing พร้อมแนบ Screenshot ของ Email ยืนยันจาก Stripe

ฉันจะดาวน์โหลดใบแจ้งหนี้ได้ที่ไหน?

ไปที่ Organization → Billing แล้วเลื่อนไปที่ส่วน Transaction History ทุก Checkout Session มีลิงก์ไปยังใบแจ้งหนี้ PDF ที่สามารถดาวน์โหลดได้

API และการเชื่อมต่อ

ฉันจะสร้าง API Token ได้อย่างไร?

ไปที่ Organization → API Tokens แล้วคลิก Create Token ตั้งชื่อที่สื่อความหมาย (เช่น "production-webhook-consumer") Token จะแสดงเพียงครั้งเดียว — คัดลอกและเก็บไว้ในที่ปลอดภัยทันที

Webhook ของฉันไม่ได้รับ Event ทำอย่างไร?

ตรวจสอบตามลำดับนี้:

1. URL ถูกต้องและเข้าถึงได้จาก Internet — ตรวจสอบว่า Endpoint ของคุณไม่อยู่หลัง Firewall หรือต้องการ VPN
2. Response Status ต้องเป็น 2xx — Ocriva ถือว่า Delivery สำเร็จก็ต่อเมื่อ Endpoint ตอบกลับ HTTP 200–299 ภายใน Timeout ที่กำหนด
3. ตรวจสอบ Delivery Logs — ใน Project → Webhooks → Delivery History จะแสดงสถานะและ Response ของทุก Attempt
4. Event Type — ตรวจสอบว่า Webhook ของคุณสมัครรับ Event type ที่ถูกต้อง (เช่น document.processed)
5. Signature Verification — หาก Endpoint ตรวจสอบ Signature และปฏิเสธ Request ที่ Signature ไม่ตรง ให้ตรวจสอบว่า Secret ตรงกัน

Rate Limit ของ API คืออะไร?

Rate Limit ถูกบังคับใช้ต่อ API Key และขึ้นอยู่กับแพ็กเกจ Subscription ของคุณ ขีดจำกัดนี้ใช้กับจำนวน AI Processing Request (ติดตามเป็น maxRequestClassA) คุณสามารถดูการใช้งานปัจจุบันและขีดจำกัดได้ที่ Organization → Limits

หากเกิน Rate Limit API จะตอบกลับด้วย 429 Too Many Requests รอให้ช่วงเวลา Rate Limit รีเซ็ตก่อนลองใหม่

ฉันจะใช้ API โดยไม่ใช้ SDK ได้หรือไม่?

ได้ Ocriva API เป็น REST API มาตรฐาน — HTTP Client ใด ๆ ก็ใช้งานได้ (curl, Postman, Python requests ฯลฯ) คุณต้องระบุ Header สองรายการในทุก Request:

• X-API-Key: <your-api-token> — การยืนยันตัวตน
• x-organization-id: <your-org-id> — บริบทขององค์กร

ตัวอย่าง curl ขั้นต่ำสำหรับการอัปโหลดเอกสาร:

curl -X POST "https://api.ocriva.com/upload" \
  -H "X-API-Key: YOUR_TOKEN" \
  -H "x-organization-id: YOUR_ORG_ID" \
  -F "file=@invoice.pdf" \
  -F "templateId=TEMPLATE_ID" \
  -F "projectId=PROJECT_ID"

ดู Reference Endpoint และ Schema Request/Response ทั้งหมดได้ที่ OpenAPI Overview

มี SDK ให้ใช้งานอะไรบ้าง?

Ocriva มี TypeScript/JavaScript SDK ที่ครอบคลุม OpenAPI Endpoint ต่าง ๆ โดยจัดการการยืนยันตัวตน การลงนาม Request การจัดการข้อผิดพลาด และ TypeScript Types โดยอัตโนมัติ

ดูคำแนะนำการติดตั้งและการใช้งานได้ที่ SDK Getting Started

API ตอบกลับ 401 ทั้งที่ Token ถูกต้อง

• ตรวจสอบว่าส่ง Token ใน Header รูปแบบ Authorization: Bearer <token> ถูกต้อง
• ตรวจสอบว่า Token ยังไม่ถูกยกเลิก (Revoke) จากหน้า API Tokens
• ตรวจสอบว่า Token สังกัดองค์กรที่ถูกต้อง Request บางประเภทต้องการ Header x-organization-id ด้วย

ข้อผิดพลาดที่พบบ่อย

"Insufficient credits" — การประมวลผลถูกบล็อก

สาเหตุ: ยอดเครดิตขององค์กรไม่เพียงพอสำหรับต้นทุนของโมเดล AI ที่ร้องขอ

วิธีแก้: ซื้อเครดิตเพิ่มที่ Organization → Billing เครดิตจะถูกเพิ่มทันทีหลังจาก Stripe ยืนยันการชำระเงิน

หากคิดว่ายอดเครดิตไม่ถูกต้อง ให้ตรวจสอบส่วน Credit History — ระบบบันทึกทุกการหักและการเพิ่มพร้อม Timestamp และ Reference

"Organization bucket is not accessible"

สาเหตุ: Cloud Storage Bucket ที่เชื่อมโยงกับองค์กรของคุณไม่สามารถเข้าถึงได้ — อาจเกิดขึ้นหากสิทธิ์ Bucket มีการเปลี่ยนแปลงหรือบริการ Storage ไม่พร้อมใช้งานชั่วคราว

วิธีแก้: ลองอัปโหลดใหม่หลังจากรอสักครู่ หากข้อผิดพลาดยังคงอยู่ ให้เปิด Support Ticket ในหมวด Bug พร้อมระบุ Organization ID ทีม Ocriva สามารถตรวจสอบการกำหนดค่า Bucket ได้

"Project validation failed" เมื่ออัปโหลด

สาเหตุ: projectId ที่ระบุในคำขออัปโหลดไม่ถูกต้อง ไม่มีอยู่จริง หรือคุณไม่ได้เป็นสมาชิกของโปรเจกต์นั้น

วิธีแก้: ยืนยัน projectId ที่ถูกต้องโดยตรวจสอบที่ Organization → Projects หากใช้ API ให้แน่ใจว่า Project ID ตรงกับองค์กรที่ระบุใน x-organization-id

"Model not found" ระหว่างการประมวลผล

สาเหตุ: โมเดล AI ที่กำหนดค่าใน Template ไม่ได้ถูกลงทะเบียนใน Model Registry ของแพลตฟอร์มอีกต่อไป หรือข้อมูลประจำตัวของผู้ให้บริการสำหรับโมเดลนั้นถูกลบออก

วิธีแก้: แก้ไข Template (Templates → Edit) แล้วเลือกโมเดล AI อื่นจากรายการที่ใช้งานได้ หากโมเดลที่ต้องการไม่ปรากฏในรายการเลย ผู้ดูแลระบบจำเป็นต้องกำหนดค่าข้อมูลประจำตัวของผู้ให้บริการใหม่

413 Payload Too Large

สาเหตุ: ไฟล์ที่อัปโหลดเกินขนาดสูงสุดที่เซิร์ฟเวอร์หรือแผนขององค์กรกำหนด

วิธีแก้: ลดขนาดไฟล์ก่อนอัปโหลด สำหรับ PDF ลองบีบอัดไฟล์หรือแบ่ง PDF หลายหน้าขนาดใหญ่ออกเป็นส่วนเล็กกว่า สำหรับรูปภาพ ให้ลดความละเอียดหรือ Export ด้วยคุณภาพที่ต่ำกว่า

ตรวจสอบขีดจำกัดขนาดไฟล์ปัจจุบันขององค์กรได้ที่ Organization → Limits ดูรายละเอียดขีดจำกัดขนาดตามแผนทั้งหมดที่หน้า Limits & Quotas

429 Too Many Requests

สาเหตุ: องค์กรของคุณเกิน Rate Limit ของ API Request สำหรับช่วงเวลาปัจจุบัน

วิธีแก้: รอให้ช่วงเวลา Rate Limit รีเซ็ตก่อนส่ง Request เพิ่มเติม Header Retry-After ในการตอบกลับ (หากมี) จะระบุจำนวนวินาทีที่ต้องรอ

สำหรับ Pipeline อัตโนมัติ ให้ใช้กลยุทธ์ Exponential Backoff: รอ 1 วินาทีหลัง 429 ครั้งแรก 2 วินาทีหลังครั้งที่สอง 4 วินาทีหลังครั้งที่สาม และต่อไปเรื่อย ๆ

ดูรูปแบบ Backoff ที่แนะนำและเอกสาร Header ได้ที่ Retry & Rate Limiting

"Template not found" หรือ "Template is not configured"

• Template อาจถูกลบหลังจากที่ไฟล์ถูกส่งเข้า Queue แล้ว
• Template อาจไม่ได้กำหนด AI Model — ไปที่หน้าแก้ไข Template และตรวจสอบว่ามีการเลือกโมเดลแล้ว
• ตรวจสอบว่า Template สังกัด Project เดียวกับไฟล์ที่อัปโหลด

เพื่อการแก้ไขที่ละเอียดขึ้น:

1. เปิด Templates ในโปรเจกต์ที่เกี่ยวข้องและยืนยันว่า Template ยังมีอยู่
2. คัดลอก Template ID โดยตรงจากหน้ารายละเอียดของ Template เพื่อหลีกเลี่ยงการพิมพ์ผิด
3. ตรวจสอบว่า projectId และ templateId ในคำขอของคุณอยู่ในโปรเจกต์เดียวกัน — Template จากโปรเจกต์ A ไม่สามารถใช้สำหรับการอัปโหลดในโปรเจกต์ B ได้

"File type not supported"

ระบบรองรับเฉพาะ PDF, PNG, JPEG, GIF, และ WebP เท่านั้น หากต้องการอัปโหลดไฟล์ประเภทอื่น เช่น DOCX หรือ XLSX ให้แปลงเป็น PDF ก่อน

"Rate limit exceeded"

จำนวนคำขอต่อช่วงเวลาเกินขีดจำกัดที่แพ็กเกจกำหนด วิธีแก้:

• รอสักครู่แล้วลองใหม่
• ใช้ Batch Processing แทนการส่งทีละไฟล์เพื่อลดจำนวน API Call
• อัปเกรดแพ็กเกจเพื่อรับขีดจำกัด maxRequestClassA ที่สูงขึ้น

"Credit was modified by another process" (ข้อผิดพลาดชั่วคราว)

สาเหตุ: Race Condition ระหว่าง Request การประมวลผลสองรายการที่เกิดขึ้นพร้อมกันและแข่งกันใช้ Credit Bucket เดียวกัน ระบบใช้ Optimistic Locking และลองใหม่อัตโนมัติสูงสุดสามครั้ง

วิธีแก้: ข้อผิดพลาดนี้มักได้รับการแก้ไขโดยอัตโนมัติ หากเห็นบน UI ให้รอสักครู่แล้วส่งใหม่ หากเกิดขึ้นซ้ำอย่างสม่ำเสมอ อาจบ่งชี้ถึงการใช้งานพร้อมกันสูงผิดปกติ — ติดต่อ Support

"Organization not found" หรือ "Access denied"

• ตรวจสอบว่าส่ง Header x-organization-id ถูกต้องใน API Request
• ตรวจสอบว่าบัญชีของคุณยังเป็นสมาชิกขององค์กรนั้น
• สำหรับผู้ใช้ผ่าน Web UI ลองล็อกออตและล็อกอินใหม่เพื่อรีเฟรช Session

ยังต้องการความช่วยเหลือ?

หากคำตอบข้างต้นไม่ตรงกับปัญหาของคุณ ให้เปิด Support Ticket:

1. ไปที่ Support → Tickets
2. คลิก New Ticket
3. เลือก Category ที่เหมาะสม: Bug, Support, หรือ Billing
4. อธิบายปัญหาอย่างละเอียด รวมถึงขั้นตอนที่ทำก่อนเกิดปัญหา, Screenshot ของ Error และ ID ที่เกี่ยวข้อง (Processing ID, Batch ID, Template ID)

ทีม Ocriva จะตรวจสอบและตอบกลับผ่าน Comment บน Ticket ของคุณ