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