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