เมื่อสร้างสคริปต์อัตโนมัติ บอท หรือเชื่อมต่อเวิร์กโฟลว์ ปัญหาที่กวนใจที่สุดไม่ใช่การเขียนโค้ด แต่คือข้อผิดพลาดกะทันหันเช่น API key invalid, 401, 403, หมดเวลาการเชื่อมต่อ บทความนี้จัดเรียงลำดับจากประสบการณ์ตรง มาเป็นรายการตรวจสอบที่ "ทำตามทีละขั้นก็หาเหตุพบ" ใช้ได้กับ ChatGPT, Claude และ Gemini
ดูก่อนว่าผิดพลาดประเภทไหน อย่าเพิ่งรีบติดตั้งใหม่
หลายคนมองปัญหาทุกอย่างเป็น "คีย์ผิด" ผลคือเสียเวลาเปล่า
- 401: คีย์ไม่ถูกต้อง, ไม่ได้ส่งคีย์ไป, พิมพ์รูปแบบผิด, โครงการไม่ได้เปิดใช้งาน
- 403: สิทธิ์ไม่เพียงพอ, ถูกจำกัดตามภูมิภาค/การควบคุมความเสี่ยง, ถูกสกัดกั้นโดยนโยบาย配额
- 429: ถูกจำกัดอัตราการเรียกใช้ หรือ配额 หมดแล้ว
- หมดเวลา/ENOTFOUND: ปัญหาเครือข่าย/DNS/พร็อกซี่ ไม่เกี่ยวกับคีย์
สาเหตุยอดนิยมที่ทำให้ API Key ใช้งานไม่ได้
อ้างอิงจากประสบการณ์แก้ไขข้อบกพร่องของปลั๊กอินที่กล่าวถึง "API key error" และปัญหาการกำหนดค่าที่พบบ่อย สรุปได้เป็นประเภทหลักๆ ดังนี้
- คัดลอกมาพร้อมช่องว่างหรือขึ้นบรรทัดใหม่เพิ่ม: โดยเฉพาะในตัวแปรสภาพแวดล้อม การมีช่องว่างเพิ่มมาแค่หนึ่งตัวท้ายสุดก็ทำให้คุณสับสนได้
- ใช้ Key ของแพลตฟอร์มผิด: Key ของ OpenAI, Anthropic และ Google ใช้แทนกันไม่ได้ อย่าเอาคีย์ของ Gemini ไปใส่ในการตั้งค่า Claude
- เขียน Request Header ผิด: คำนำหน้า Authorization, ชื่อฟิลด์ Header ใช้ตัวพิมพ์ใหญ่-เล็กผิด, ลืมเขียนคำว่า Bearer
- โครงการไม่ได้เปิดใช้งานการคิดค่าบริสิทธิ์/สิทธิ์การใช้งาน: คีย์ถูกต้อง แต่บัญชีไม่ได้เปิดสิทธิ์ API ที่ตรงกัน ก็จะถูกปฏิเสธ
ข้อผิดพลาด 403 ถูกจำกัดการเข้าถึง ตรวจสอบ重点ที่ภูมิภาคและ出口
403 น่าหงุดหงิดที่สุด เพราะมันมักไม่บอกว่า "ผิดตรงไหน" จากประสบการณ์ แนะนำให้ตรวจสอบIP出口 และกฎของพร็อกซี่ ก่อน แล้วค่อยตรวจสอบสิทธิ์ของบัญชี


