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

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

หากพบปัญหาเกี่ยวกับคีย์ API โปรดตรวจสอบว่าคุณได้ตั้งค่าคีย์ API อย่างถูกต้องตามคู่มือการตั้งค่าคีย์ API

รหัสข้อผิดพลาดของบริการแบ็กเอนด์ Gemini API

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

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

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

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

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

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

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

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

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

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

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

ปัญหาเกี่ยวกับการท่องจำ

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

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

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

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

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

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

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

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

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

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