คู่มือการแก้ปัญหา

ใช้คู่มือนี้ช่วยวิเคราะห์และแก้ไขปัญหาทั่วไปที่เกิดขึ้นเมื่อ ที่คุณเรียกใช้ Gemini API หากพบปัญหาเกี่ยวกับคีย์ API ให้ตรวจสอบว่าคุณตั้งค่าแล้ว คีย์ API อย่างถูกต้องตามคู่มือการตั้งค่าคีย์ API

รหัสข้อผิดพลาด

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

รหัส HTTP สถานะ คำอธิบาย โซลูชัน
400 ไม่ถูกต้อง เนื้อหาของคำขอมีรูปแบบไม่ถูกต้อง ตรวจสอบเอกสารอ้างอิง API เพื่อดูรูปแบบคำขอ ตัวอย่าง และเวอร์ชันที่รองรับ การใช้ฟีเจอร์จาก API เวอร์ชันใหม่กับปลายทางเก่าอาจทำให้เกิดข้อผิดพลาดได้
400 FAILED_PRECONDITION Gemini API รุ่นฟรีไม่พร้อมใช้งานในประเทศของคุณ โปรดเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ใน Google AI Studio หากต้องการใช้ Gemini API คุณจะต้องตั้งค่าแพ็กเกจการชำระเงินโดยใช้ Google AI Studio
403 PERMISSION_DENIED คีย์ API ไม่มีสิทธิ์ที่จำเป็น ตรวจสอบว่าคีย์ API ได้รับการตั้งค่าและมีสิทธิ์เข้าถึงที่ถูกต้อง
404 NOT_FOUND ไม่พบทรัพยากรที่ขอ ตรวจสอบว่าพารามิเตอร์ทั้งหมดในคําขอถูกต้องสําหรับเวอร์ชัน API ของคุณ
429 RESOURCE_EXHAUSTED คุณเกินขีดจำกัดอัตราคำขอแล้ว ตรวจสอบว่าคุณอยู่ภายในขีดจำกัดอัตราของรูปแบบ ขอเพิ่มโควต้าหากจำเป็น
500 ภายใน เกิดข้อผิดพลาดที่ไม่คาดคิดทางฝั่งของ Google โปรดรอสักครู่แล้วลองอีกครั้ง หากปัญหายังคงอยู่หลังจากลองอีกครั้ง โปรดรายงานปัญหาโดยใช้ปุ่มส่งความคิดเห็นใน Google AI Studio
503 UNAVAILABLE บริการอาจทำงานหนักเกินไปหรือหยุดทำงานชั่วคราว โปรดรอสักครู่แล้วลองอีกครั้ง หากปัญหายังคงอยู่หลังจากลองอีกครั้ง โปรดรายงานปัญหาโดยใช้ปุ่มส่งความคิดเห็นใน Google AI Studio

ตรวจสอบการเรียก API เพื่อหาข้อผิดพลาดของพารามิเตอร์โมเดล

ตรวจสอบว่าพารามิเตอร์โมเดลอยู่ภายในค่าต่อไปนี้

พารามิเตอร์โมเดล ค่า (ช่วง)
จำนวนผู้สมัคร 1-8 (จำนวนเต็ม)
อุณหภูมิ 0.0-1.0
โทเค็นเอาต์พุตสูงสุด ใช้ get_model (Python) เพื่อกำหนดจำนวนโทเค็นสูงสุดของโมเดลที่คุณใช้
TopP 0.0-1.0

นอกจากการตรวจสอบค่าพารามิเตอร์แล้ว อย่าลืมตรวจสอบว่าคุณใช้พารามิเตอร์ เวอร์ชัน API (เช่น /v1 หรือ /v1beta) และ รุ่นที่รองรับฟีเจอร์ที่คุณต้องการ เช่น หากฟีเจอร์อยู่ในเวอร์ชันเบต้า รุ่นดังกล่าว จะพร้อมใช้งานในเวอร์ชัน API ของ /v1beta เท่านั้น

ตรวจสอบว่าคุณมีรุ่นที่ถูกต้อง

ตรวจสอบว่าคุณใช้โมเดลที่รองรับที่แสดงอยู่ใน หน้าโมเดล

ปัญหาด้านความปลอดภัย

หากคุณเห็นข้อความแจ้งถูกบล็อกเนื่องจากการตั้งค่าความปลอดภัยในการเรียก API ตรวจสอบข้อความแจ้งเกี่ยวกับตัวกรองที่คุณตั้งค่าไว้ในการเรียก API

หากคุณเห็น BlockedReason.OTHER คำตอบหรือคำถามอาจละเมิดข้อกำหนด บริการหรือไม่ได้รับการสนับสนุน

ปรับปรุงเอาต์พุตของโมเดล

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

หากคุณมีตัวอย่างคู่อินพุต/เอาต์พุตที่ดีหลายร้อยคู่ คุณยังสามารถ ลองพิจารณาการปรับแต่งโมเดล

ทำความเข้าใจขีดจำกัดของโทเค็น

อ่านคำแนะนำเกี่ยวกับโทเค็นเพื่อให้เข้าใจมากขึ้นถึงวิธีการ เพื่อนับโทเค็นและขีดจำกัดของโทเค็น

ปัญหาที่ทราบ

  • API รองรับเฉพาะภาษาอังกฤษเท่านั้น การส่งพรอมต์ในภาษาต่างๆ สามารถ จะสร้างคำตอบที่ไม่คาดคิดหรือแม้กระทั่งถูกบล็อก ดูพร้อมใช้งาน ภาษาเพื่ออัปเดตข้อมูล

รายงานข้อบกพร่อง

เข้าร่วมการสนทนาในฟอรัมนักพัฒนาซอฟต์แวร์ AI ของ Google เมื่อมีข้อสงสัย