คู่มือแก้ไขข้อผิดพลาดทั่วไปของ Claude API: วิธีแก้ไข 401 Unauthorized และ 429 Rate Limit

นักพัฒนามักเจอข้อผิดพลาด 401 Authentication Failed หรือ 429 Rate Limit เมื่อใช้งาน Claude API ซึ่งส่งผลต่อความเสถียรของบริการ บทความนี้รวบรวมสาเหตุและขั้นตอนการแก้ไขข้อผิดพลาดยอดนิยม ช่วยให้คุณกลับมาเรียกใช้งานได้อย่างรวดเร็ว

ข้อผิดพลาด 401 Unauthorized: ตรวจสอบ API Key และสิทธิ์การเข้าถึง

การได้รับรหัส 401 มักหมายถึง API Key ไม่ถูกต้อง หมดอายุ หรือไม่ได้ส่งค่าอย่างถูกต้อง ขั้นแรกให้ตรวจสอบใน Header ของ Request ว่า Authorization อยู่ในรูปแบบ Bearer YOUR_API_KEY โดยระวังเรื่องตัวพิมพ์เล็ก-ใหญ่ และช่องว่างท้าย หาก Key ถูกโหลดผ่าน Environment Variable ให้ตรวจสอบว่าชื่อตัวแปรสะกดถูกต้อง

ในบางกรณี Key ถูกจำกัดโดยนโยบายขององค์กร ทำให้ไม่สามารถเรียกใช้โมเดลบางตัว (เช่น claude-3-opus) เข้าสู่ระบบ Anthropic Console เพื่อตรวจสอบขอบเขตสิทธิ์ของ API Key หากจำเป็นให้สร้าง Key ใหม่และเชื่อมโยงกับ Project ใหม่

ข้อผิดพลาด 429 Rate Limit: ควบคุมความถี่ของการร้องขออย่างเหมาะสม

รหัส 429 หมายถึงจำนวน Request เกินกว่า Quota ต่อนาที Claude API มีข้อจำกัดทั้งจำนวน Request และจำนวน Token คุณสามารถตรวจสอบเครดิตคงเหลือได้จาก Response Header X-RateLimit-Remaining แนะนำให้ใช้กลไก Exponential Backoff Retry ในโค้ด: รอ 1 วินาทีในครั้งแรก หากล้มเหลวให้เพิ่มเวลารอเป็นสองเท่าสูงสุด 30 วินาที

หากเกิด 429 บ่อยครั้ง สามารถขออัปเกรด Package Quota หรือใช้วิธีการ Batch Request เพื่อลดความถี่ หลีกเลี่ยงการส่ง Request สั้น ๆ จำนวนมากพร้อมกันในช่วงเวลาสั้น

ข้อผิดพลาด 500 Server Error และกลยุทธ์การ Retry

รหัส 500 บ่งชี้ว่าฝั่ง Server ของ Claude มีปัญหาชั่วคราว ซึ่งมักเกิดจากโหลดสูงหรือข้อผิดพลาดภายใน ข้อผิดพลาดประเภทนี้ส่วนมากเป็นแบบชั่วคราว รอไม่กี่วินาทีก็จะกลับมาเป็นปกติ แนะนำให้ทำ Retry อย่างน้อย 3 ครั้ง โดยเว้นระยะ 2-4 วินาที และใช้พารามิเตอร์ max_retries เพื่อควบคุมไม่ให้ Retry ไม่สิ้นสุด

ในเวลาเดียวกัน ให้ตรวจสอบว่า Parameter ใน Request Body ถูกต้องหรือไม่ — ค่า max_tokens ที่มากเกินไป หรือรูปแบบ Message Body ที่ผิดพลาดบางครั้งก็ทำให้เกิด 500 การใช้ Official Python SDK หรือทำ JSON Schema Validation ก่อนเรียกใช้จะช่วยลดปัญหาเหล่านี้ได้