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

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

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

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

รหัส HTTP สถานะ คำอธิบาย โซลูชัน
400 INVALID_ARGUMENT เนื้อหาของคำขอมีรูปแบบไม่ถูกต้อง ตรวจสอบข้อมูลอ้างอิง API เพื่อดูรูปแบบคำขอ ตัวอย่าง และเวอร์ชันที่รองรับ การใช้ฟีเจอร์จาก API เวอร์ชันใหม่ที่มีปลายทางเวอร์ชันเก่าอาจทำให้เกิดข้อผิดพลาด
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 เท่านั้น

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

ตรวจสอบว่าคุณกำลังใช้โมเดลที่รองรับ ใช้ list_models (Python) เพื่อทำให้โมเดลทั้งหมดพร้อมใช้งาน

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

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

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

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

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

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

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

ใช้ ModelService API เพื่อดูข้อมูลเมตาเพิ่มเติมเกี่ยวกับโมเดล รวมถึงขีดจำกัดโทเค็นอินพุตและเอาต์พุต

หากต้องการรับโทเค็นที่พรอมต์ใช้ ให้ใช้ countMessageTokens สำหรับโมเดลแชทและ countTextTokens สำหรับโมเดลข้อความ

ปัญหาที่ทราบแล้ว

  • การรองรับ Google AI Studio บนอุปกรณ์เคลื่อนที่: แม้ว่าคุณจะเปิดเว็บไซต์ในอุปกรณ์เคลื่อนที่ได้ แต่เว็บไซต์ยังไม่ได้รับการเพิ่มประสิทธิภาพเพื่อหน้าจอขนาดเล็ก
  • API รองรับเฉพาะภาษาอังกฤษเท่านั้น การส่งพรอมต์เป็นภาษาต่างๆ อาจสร้าง คำตอบที่ไม่คาดคิดหรือแม้แต่ถูกบล็อกได้ ดูภาษาที่มีให้บริการสำหรับข้อมูลอัปเดต

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

รายงานปัญหาใน GitHub เพื่อถามคำถามหรือส่งคำขอฟีเจอร์หรือข้อบกพร่อง