หน้านี้จะอธิบายการแก้ปัญหารหัสข้อผิดพลาดที่พบบ่อยสำหรับ SDK ของ Gemini API และ Firebase AI Logic
ข้อผิดพลาด 400: API key not valid. Please pass a valid API key.
หากได้รับข้อผิดพลาด 400 ที่ระบุว่า
API key not valid. Please pass a valid API key. โดยปกติแล้วหมายความว่า
ไม่มีคีย์ API ในไฟล์/ออบเจ็กต์การกำหนดค่า Firebase หรือไม่ได้ตั้งค่า
ให้ใช้กับแอปและ/หรือโปรเจ็กต์ Firebase
ตรวจสอบว่าคีย์ API ที่แสดงในไฟล์/ออบเจ็กต์การกำหนดค่า Firebase ตรงกับคีย์ API ของแอป คุณดูคีย์ API ทั้งหมดได้ในแผง API และบริการ > ข้อมูลเข้าสู่ระบบ ในคอนโซล Google Cloud
หากพบว่าไม่ตรงกัน ให้ รับไฟล์/ออบเจ็กต์การกำหนดค่า Firebase ใหม่ แล้วแทนที่ไฟล์/ออบเจ็กต์ที่มีอยู่ในแอป ไฟล์/ออบเจ็กต์การกำหนดค่าใหม่ ควรมีคีย์ API ที่ถูกต้องสำหรับแอปและโปรเจ็กต์ Firebase
ข้อผิดพลาด 400: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
หากพยายามส่งคำขอแบบมัลติโมดัลด้วย Cloud Storage for Firebase
URL คุณอาจพบข้อผิดพลาด 400 ต่อไปนี้
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
ข้อผิดพลาดนี้เกิดจากโปรเจ็กต์ที่ไม่ได้จัดสรรตัวแทนบริการที่จำเป็นโดยอัตโนมัติอย่างถูกต้องเมื่อมีการเปิดใช้ Agent Platform API ในโปรเจ็กต์ ปัญหานี้เป็นปัญหาที่ทราบอยู่แล้วในบางโปรเจ็กต์ และเรากำลังดำเนินการแก้ไข ทั่วโลก
วิธีแก้ปัญหาเพื่อแก้ไขโปรเจ็กต์และจัดสรรตัวแทนบริการเหล่านี้อย่างถูกต้องเพื่อให้คุณเริ่มรวม Cloud Storage for Firebase URL ในคำขอแบบมัลติโมดัลได้มีดังนี้ คุณต้องเป็นเจ้าของโปรเจ็กต์ และคุณต้อง ทํางานชุดนี้ให้เสร็จสมบูรณ์เพียงครั้งเดียวสําหรับโปรเจ็กต์
เข้าถึงและตรวจสอบสิทธิ์ด้วย gcloud CLI
วิธีที่ง่ายที่สุดในการดำเนินการนี้คือการดำเนินการจาก Cloud Shell ดูข้อมูลเพิ่มเติมในGoogle Cloudเอกสารประกอบหากได้รับข้อความแจ้ง ให้ทำตามวิธีการที่แสดงในเทอร์มินัลเพื่อเรียกใช้ gcloud CLI กับโปรเจ็กต์ Firebase
คุณจะต้องมีรหัสโปรเจ็กต์ Firebase ซึ่งดูได้ที่ด้านบนของ settings การตั้งค่าโปรเจ็กต์ ในคอนโซล Firebase
จัดสรรตัวแทนบริการที่จำเป็นในโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
รอสักครู่เพื่อให้ระบบจัดสรรตัวแทนบริการ แล้วลองส่งคำขอแบบมัลติโมดัลที่มี Cloud Storage for Firebase URL อีกครั้ง
หากยังคงได้รับข้อผิดพลาดนี้หลังจากรอหลายนาที โปรดติดต่อทีมสนับสนุนของ Firebase
ข้อผิดพลาด 403: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
หากได้รับ403 - PERMISSION_DENIEDข้อผิดพลาดที่ระบุว่า
To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
แสดงว่าคำขอของคุณไม่มีโทเค็น App Check ที่ถูกต้องและคุณ
พยายามเข้าถึงโมเดลที่มักถูกละเมิด
ระบบพบว่าโมเดล Generative บางโมเดลเป็นที่นิยมในหมู่ผู้ไม่ประสงค์ดีที่ ใช้ในทางที่ผิด
เนื่องจากคุณไม่ได้App Checkบังคับใช้สำหรับ Firebase AI Logic โปรเจ็กต์ของคุณจึงเสี่ยงต่อการละเมิดโมเดลเหล่านี้ Firebase จะบล็อกการเข้าถึงโมเดลเหล่านี้เพื่อช่วยปกป้องนักพัฒนาแอปของเรา เว้นแต่คำขอจะมีโทเค็น App Check ที่ถูกต้อง (ซึ่งหมายความว่ามีการบังคับใช้ App Check สำหรับ Firebase AI Logic)
หากต้องการเข้าถึงโมเดลที่แสดงข้อผิดพลาด ให้ทำดังนี้
ตั้งค่า App Check สำหรับ Firebase AI Logic สำหรับการพัฒนาในเครื่อง ให้ตรวจสอบว่าคุณได้ตั้งค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องแล้ว
การบังคับใช้ App Check มีความสำคัญอย่างยิ่งต่อการช่วยปกป้อง Gemini API และ โมเดล Gemini จากการละเมิด และจำเป็นต้องมีการบังคับใช้เพื่อแก้ไขข้อผิดพลาดนี้
ส่งคำขอจากแอปของคุณไปยัง Firebase AI Logic อีกครั้ง
คำขอนี้จะส่งโทเค็น App Check ที่ถูกต้อง และคุณจะไม่ได้รับข้อผิดพลาด
403 - PERMISSION_DENIEDนี้อีกต่อไปก่อนที่จะเผยแพร่แอปต่อผู้ใช้ปลายทาง คุณต้อง ตั้งค่าผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริง (เช่น App Attest, Play Integrity หรือ reCAPTCHA Enterprise) เพื่อให้ ผู้ใช้ปลายทางเข้าถึงฟีเจอร์ AI ได้เมื่อมีการบังคับใช้ App Check
ข้อผิดพลาด 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
หากได้รับ403 - PERMISSION_DENIEDข้อผิดพลาดที่ระบุว่า
Firebase AI Logic has been deactivated in this project. To resume using
Firebase AI Logic, you must enforce Firebase App Check. Learn more:
https://firebase.google.com/docs/ai-logic/app-check
แสดงว่าระบบระบุโปรเจ็กต์ Firebase ของคุณว่าไม่มีการใช้งาน และคุณ
ไม่ได้App Checkบังคับใช้สำหรับ Firebase AI Logic
"โปรเจ็กต์ที่ไม่ได้ใช้งาน" คือโปรเจ็กต์ที่Firebase AI Logic เปิดใช้ แต่ไม่มีการใช้งาน Firebase AI Logic ในช่วงที่ผ่านมา
เนื่องจากคุณไม่ได้บังคับใช้ App Check สำหรับ Firebase AI Logic โปรเจ็กต์ของคุณจึงเสี่ยงต่อการละเมิด Gemini API Firebase ได้ปิดใช้งานการใช้ Firebase AI Logic จนกว่าคุณจะบังคับใช้ App Check สำหรับ Firebase AI Logic เพื่อช่วยปกป้องโปรเจ็กต์ของคุณ
เมื่อพร้อมที่จะเริ่มใช้ Firebase AI Logic อีกครั้ง ให้ทำดังนี้
ตั้งค่า App Check สำหรับ Firebase AI Logic สำหรับการพัฒนาในเครื่อง ให้ตรวจสอบว่าคุณได้ตั้งค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องแล้ว
การบังคับใช้ App Check มีความสำคัญอย่างยิ่งต่อการช่วยปกป้อง Gemini API และ โมเดล Gemini จากการละเมิด และจำเป็นต้องมีการบังคับใช้เพื่อแก้ไขข้อผิดพลาดนี้
ส่งคำขอจากแอปของคุณไปยัง Firebase AI Logic อีกครั้ง
คำขอนี้จะส่งโทเค็น App Check ที่ถูกต้อง และคุณจะไม่ได้รับข้อผิดพลาด
403 - PERMISSION_DENIEDนี้อีกต่อไปหากคุณบังคับใช้ App Check อยู่แล้วและยังคงได้รับข้อผิดพลาดนี้ ให้ตรวจสอบว่าได้เปิดการป้องกันการเล่นซ้ำสำหรับ Firebase AI Logic หรือไม่ (รวมถึงในโหมด "ตรวจสอบเท่านั้น")
เมื่อเปิดการป้องกันการเล่นซ้ำ ระบบจะนับเฉพาะโทเค็นแบบใช้ได้จำกัดเป็นโทเค็นที่ยืนยันแล้ว สำหรับ Firebase AI Logic ส่วนโทเค็นเซสชันปกติจะไม่ล้างข้อผิดพลาดนี้ เปิดใช้โทเค็นแบบใช้ครั้งเดียวในแอป หรือปิดการป้องกันการเล่นซ้ำสำหรับ Firebase AI Logic ส่งคำขออีกครั้ง และรอประมาณ 1 วันก่อนที่จะเปิดการป้องกันการเล่นซ้ำอีกครั้ง (ระบบจะประเมินกิจกรรมของโปรเจ็กต์ใหม่ทุกวัน)
ก่อนที่จะเผยแพร่แอปต่อผู้ใช้ปลายทาง คุณต้อง ตั้งค่าผู้ให้บริการการรับรองเวอร์ชันที่ใช้งานจริง (เช่น App Attest, Play Integrity หรือ reCAPTCHA Enterprise) เพื่อให้ ผู้ใช้ปลายทางเข้าถึงฟีเจอร์ AI ได้เมื่อมีการบังคับใช้ App Check
ข้อผิดพลาด 403: PERMISSION_DENIED: The caller does not have permission.
หากได้รับข้อผิดพลาด 403 ที่ระบุว่า
PERMISSION_DENIED: The caller does not have permission. โดยปกติแล้วหมายความว่า
คีย์ API ในไฟล์/ออบเจ็กต์การกำหนดค่า Firebase เป็นของโปรเจ็กต์ Firebase อื่น
ตรวจสอบว่าคีย์ API ที่แสดงในไฟล์/ออบเจ็กต์การกำหนดค่า Firebase ตรงกับคีย์ API ของแอป คุณดูคีย์ API ทั้งหมดได้ในแผง API และบริการ > ข้อมูลเข้าสู่ระบบ ในคอนโซล Google Cloud
หากพบว่าไม่ตรงกัน ให้ รับไฟล์/ออบเจ็กต์การกำหนดค่า Firebase ใหม่ แล้วแทนที่ไฟล์/ออบเจ็กต์ที่มีอยู่ในแอป ไฟล์/ออบเจ็กต์การกำหนดค่าใหม่ ควรมีคีย์ API ที่ถูกต้องสำหรับแอปและโปรเจ็กต์ Firebase
ข้อผิดพลาด 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.
หากได้รับข้อผิดพลาด 403 ที่ระบุว่า
Requests to this API firebasevertexai.googleapis.com ... are blocked. แสดงว่า
โดยปกติแล้วคีย์ API ในการกำหนดค่า Firebase ในแอปมี
ข้อจำกัดที่ทำให้เรียก API ที่จำเป็นไม่ได้
หากต้องการแก้ไขปัญหานี้ คุณต้องอัปเดตข้อจำกัดของคีย์ API ในGoogle Cloudคอนโซลให้รวม API ที่จำเป็น สำหรับ Firebase AI Logic,
คุณต้องตรวจสอบว่า Firebase AI Logic API
(firebasevertexai.googleapis.com) อยู่ในรายการ API ที่เลือก
ซึ่งเรียกได้โดยใช้คีย์ API
โปรดทำตามขั้นตอนต่อไปนี้
ในGoogle Cloud คอนโซล ให้เปิดแผง API และบริการ > ข้อมูลเข้าสู่ระบบ
เลือกคีย์ API ที่กำหนดค่าให้แอปพลิเคชันของคุณใช้ (เช่น คีย์ iOS สำหรับแอป iOS)
ในหน้าแก้ไขคีย์ API ให้ค้นหาส่วนข้อจำกัดของ API
ตรวจสอบว่าได้เลือกตัวเลือกจำกัดคีย์ หากไม่ได้ระบุไว้ แสดงว่าคีย์ของคุณ ไม่จำกัด และอาจไม่ใช่สาเหตุของข้อผิดพลาด
ในเมนูแบบเลื่อนลงAPI ที่เลือก ให้ค้นหาและเลือก Firebase AI Logic API เพื่อเพิ่มลงในรายการ API ที่เลือกซึ่งเรียกใช้ได้โดยใช้คีย์ API
คลิกบันทึก
การเปลี่ยนแปลงอาจใช้เวลาสูงสุด 5 นาทีจึงจะมีผล
ข้อผิดพลาด 404: Firebase AI Logic genai config not found
หากได้รับข้อผิดพลาด 404 ที่ระบุว่า Firebase AI Logic genai config not found
โดยปกติแล้วจะหมายความว่าการตั้งค่าสำหรับ Firebase AI Logic มีการกำหนดค่าไม่ถูกต้องหรือ
ขาดหายไป
สาเหตุที่พบบ่อยที่สุดของข้อผิดพลาดนี้มีดังนี้
คุณยังไม่ได้ตั้งค่าโปรเจ็กต์ Firebase สำหรับผู้ให้บริการ Gemini API
สิ่งที่ต้องทำ
ในคอนโซล Firebase ให้ไปที่บริการ AI > ตรรกะ AI คลิกเริ่มต้นใช้งาน แล้วเลือกผู้ให้บริการ Gemini API ที่ต้องการ เปิดใช้ API แล้ว Firebase จะตั้งค่า โปรเจ็กต์สำหรับผู้ให้บริการรายนั้น หลังจากทำเวิร์กโฟลว์เสร็จแล้ว ให้ลองส่งคำขออีกครั้งหากคุณเพิ่งทําตามFirebase AI Logicเวิร์กโฟลว์การตั้งค่าใน Firebaseคอนโซล ระบบอาจยังไม่พร้อมใช้งานการกําหนดค่าสําหรับ Firebase AI Logic ในบริการแบ็กเอนด์ที่จําเป็นทั้งหมดในทุกภูมิภาคที่เกี่ยวข้อง
สิ่งที่ต้องทำ
รอสักครู่ แล้วลองส่งคำขออีกครั้ง
ข้อผิดพลาด 404: โมเดล "was not found or your project does not have access to it"
เช่น "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."
คุณอาจได้รับข้อผิดพลาดเช่นนี้เนื่องจากสาเหตุบางประการ
ชื่อรุ่นไม่ถูกต้อง
สาเหตุ: ชื่อรุ่นที่คุณระบุไม่ใช่ชื่อรุ่นที่ถูกต้อง
แก้ไข: ตรวจสอบชื่อรุ่นและเวอร์ชันรุ่นกับรายการรุ่นทั้งหมดที่รองรับและพร้อมใช้งาน อย่าลืมตรวจสอบกลุ่มและลำดับของกลุ่มในชื่อโมเดล เช่น
- Gemini 3.x Pro
ชื่อโมเดลล่าสุด:
gemini-3.1-pro-preview(พร้อมใช้งานในเวอร์ชันตัวอย่างเท่านั้น) - Gemini 3.x Flash
ชื่อรุ่นล่าสุด:
gemini-3.8-flash - Gemini 3.x Flash‑Lite
ชื่อรุ่นล่าสุด:
gemini-3.5-flash-lite - ชื่อโมเดลล่าสุด Gemini 3.x Pro Image (หรือที่เรียกว่า "Nano Banana Pro")
gemini-3-pro-image - ชื่อโมเดลล่าสุด Gemini 3.x Flash Image (หรือที่เรียกว่า "Nano Banana 2")
gemini-3.1-flash-image - รุ่นล่าสุด Gemini 3.x Flash‑Lite Image (หรือที่เรียกว่า "Nano Banana 2 Lite")
ชื่อรุ่น:
gemini-3.1-flash-lite-image - ชื่อโมเดลล่าสุด Gemini 2.5 Flash Image (หรือที่เรียกว่า "Nano Banana")
gemini-2.5-flash-image
- Gemini 3.x Pro
ชื่อโมเดลล่าสุด:
สถานที่ตั้งไม่ถูกต้อง (ใช้ได้เฉพาะในกรณีที่ใช้ผู้ให้บริการ Agent Platform Gemini API (formerly Vertex AI))
สาเหตุ: คำขอของคุณอาจพยายามเข้าถึงโมเดลในสถานที่ตั้ง ที่โมเดลไม่พร้อมใช้งาน
แก้ไข: ตรวจสอบว่าคำขอของคุณพยายามเข้าถึงโมเดลที่พร้อมใช้งาน
เมื่อใช้ Agent Platform Gemini API (formerly Vertex AI) คุณจะระบุตำแหน่งเพื่อเข้าถึงโมเดลในระหว่างการเริ่มต้นได้ (ไม่บังคับ) หากไม่ได้ระบุตำแหน่ง Firebase AI Logic จะใช้ตำแหน่งต่อไปนี้เป็นค่าเริ่มต้น
- เมื่อใช้ไวยากรณ์การเริ่มต้น "Agent Platform" ให้ทำดังนี้
global - เมื่อใช้ไวยากรณ์การเริ่มต้น "Vertex AI" แบบเดิม
us-central1
อย่างไรก็ตาม โมเดลบางรุ่นอาจไม่รองรับในตำแหน่งเริ่มต้นเหล่านี้ ซึ่งหมายความว่าคุณอาจต้องระบุตำแหน่งที่เฉพาะเจาะจงอย่างชัดเจนในระหว่างการเริ่มต้น ทั้งนี้ขึ้นอยู่กับรุ่น
Gemini โมเดลตัวอย่างและเวอร์ชันทดลอง: พร้อมให้บริการเฉพาะ ใน
globalGemini 3.x โมเดลที่เสถียร: พร้อมให้บริการ ใน
globalและมักจะพร้อมให้บริการในusและeuโมเดล Gemini 2.5: พร้อมให้บริการในหลายพื้นที่ โปรดทราบว่าโมเดล Gemini Live API 2.5 ไม่พร้อมให้บริการใน
global
- เมื่อใช้ไวยากรณ์การเริ่มต้น "Agent Platform" ให้ทำดังนี้
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธี ระบุสถานที่ตั้งสำหรับการเข้าถึงโมเดล (รวมถึงข้อมูลโค้ด)
ข้อผิดพลาด 429: "You exceeded your current quota, please check your plan and billing details" หรือ "Resource exhausted, please try again later."
คุณอาจได้รับข้อผิดพลาดเช่นนี้เนื่องจากสาเหตุบางประการ
คุณใช้เกินโควต้าหรือโมเดลที่คุณเข้าถึงมีคำขอจากผู้อื่นมากเกินไป
การดำเนินการที่จะทำจะขึ้นอยู่กับว่าคุณใช้ Gemini Developer API หรือ Agent Platform Gemini API (formerly Vertex AI) ดูข้อมูลเพิ่มเติมเกี่ยวกับโควต้าและวิธีขอโควต้าเพิ่มเติมได้ที่ ขีดจำกัดอัตราและโควต้า
หากคุณใช้ Agent Platform Gemini API (formerly Vertex AI) เอกสารประกอบ Google Cloud จะให้บริบทและคำแนะนำเพิ่มเติมสำหรับ รหัสข้อผิดพลาด 429
คุณพยายามใช้โมเดลหรือฟีเจอร์ที่ต้องมีการเรียกเก็บเงิน แต่โปรเจ็กต์ Firebase ของคุณใช้แพ็กเกจราคา Spark
หากใช้ Gemini Developer API คุณจะได้รับสิทธิ์เข้าถึงแบบจำกัด ในโมเดลบางอย่างและสิทธิ์เข้าถึงฟีเจอร์พื้นฐานหลายอย่างขณะใช้ Gemini Developer API "รุ่นฟรี" ระดับนี้ช่วยให้คุณเริ่มต้นใช้งานได้ โดยไม่ต้องระบุวิธีการชำระเงิน ซึ่งหมายความว่าคุณไม่จำเป็นต้อง อัปเกรดโปรเจ็กต์ Firebase เป็นแพ็กเกจราคา Blaze แบบจ่ายเมื่อใช้
โมเดลบางรายการไม่พร้อมใช้งานในGemini Developer API "รุ่นฟรี" และต้องใช้ "ระดับแบบชำระเงิน" ซึ่งหมายความว่าโปรเจ็กต์ของคุณต้องใช้ แพ็กเกจราคา Blaze แบบจ่ายเมื่อใช้ ตัวอย่างเช่น โมเดลต่อไปนี้มักจะต้องมีการเรียกเก็บเงิน
- โมเดลตัวอย่างและเวอร์ชันทดลองส่วนใหญ่
- โมเดลการสร้างรูปภาพ (โมเดล "Nano Banana")
โมเดลบางรุ่นมีฟีเจอร์พื้นฐานบางอย่างในGemini Developer API "ระดับฟรี" แต่ต้องใช้ "ระดับแบบชำระเงิน" เพื่อใช้ฟีเจอร์ขั้นสูงเพิ่มเติม เช่น
- เมื่อใช้โมเดล Gemini 3.x ส่วนใหญ่
การเชื่อมโยงกับ
Google Search หรือGoogle Maps จะต้องมีการเรียกเก็บเงิน
- เมื่อใช้โมเดล Gemini 3.x ส่วนใหญ่
การเชื่อมโยงกับ
ดูข้อมูลเกี่ยวกับแพ็กเกจราคาของ Firebase และ Gemini Developer API
ดูรายละเอียดเพิ่มเติมได้ที่Gemini Developer API เอกสารประกอบเรื่องราคา และ คำถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน