หน้านี้จะแสดงการแก้ปัญหารหัสข้อผิดพลาดที่พบบ่อยสำหรับ Gemini API และ Firebase AI Logic SDK
ข้อผิดพลาด 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
หากพบว่าคีย์ API ไม่ตรงกัน ให้ รับไฟล์/ออบเจ็กต์การกำหนดค่า 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 บริการที่จำเป็น โดยอัตโนมัติอย่างถูกต้องเมื่อเปิดใช้ Agent Platform API ใน โปรเจ็กต์ ซึ่งเป็นปัญหาที่ทราบกันดีในบางโปรเจ็กต์ และเรากำลังดำเนินการแก้ไขปัญหานี้ในระดับโลก
วิธีแก้ปัญหาเพื่อแก้ไขโปรเจ็กต์และจัดเตรียม Agent บริการเหล่านี้อย่างถูกต้องเพื่อให้คุณเริ่มรวม Cloud Storage for Firebase URL ไว้ในคำขอแบบมัลติโมดัลได้มีดังนี้ คุณต้องเป็น เจ้าของโปรเจ็กต์ และต้อง ทำชุดงานนี้เพียงครั้งเดียวสำหรับโปรเจ็กต์
เข้าถึงและตรวจสอบสิทธิ์ด้วย gcloud CLI
วิธีที่ง่ายที่สุดคือการดำเนินการจาก Cloud Shell ดูข้อมูลเพิ่มเติมได้ใน Google Cloudเอกสารประกอบหากได้รับข้อความแจ้ง ให้ทำตามวิธีการที่แสดงในเทอร์มินัลเพื่อทำให้ gcloud CLI ทำงานกับโปรเจ็กต์ Firebase
คุณจะต้องใช้รหัสโปรเจ็กต์ Firebase ซึ่งดูได้ที่ด้านบนของ settings การตั้งค่าโปรเจ็กต์ ในคอนโซล Firebase
จัดเตรียม Agent บริการที่จำเป็นในโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้
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 ''
รอสักครู่เพื่อให้แน่ใจว่าได้จัดเตรียม Agent บริการแล้ว จากนั้นลองส่งคำขอแบบมัลติโมดัลที่มี 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 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
หากพบว่าคีย์ API ไม่ตรงกัน ให้ รับไฟล์/ออบเจ็กต์การกำหนดค่า 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 Logic คลิกเริ่มต้นใช้งาน แล้วเลือก ผู้ให้บริการGemini API ที่ต้องการ เปิดใช้ API แล้ว Firebase จะตั้งค่าโปรเจ็กต์สำหรับผู้ให้บริการรายนั้น หลังจากทำเวิร์กโฟลว์เสร็จแล้ว ให้ลองส่งคำขออีกครั้งหากคุณเพิ่งทำตามเวิร์กโฟลว์การตั้งค่า Firebase AI Logic ใน คอนโซล Firebase เมื่อเร็วๆ นี้ การกำหนดค่าสำหรับ Firebase AI Logic อาจยังไม่พร้อมใช้งานสำหรับบริการแบ็กเอนด์ที่จำเป็นทั้งหมดในทุกภูมิภาคที่เกี่ยวข้อง
สิ่งที่ต้องทำ:
รอสักครู่ แล้วลองส่งคำขออีกครั้ง
ข้อผิดพลาด 404: the model "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."
ข้อผิดพลาดเช่นนี้อาจเกิดขึ้นได้จาก 2 สาเหตุ
ชื่อโมเดลไม่ถูกต้อง
สาเหตุ: ชื่อโมเดลที่คุณระบุไม่ใช่ชื่อโมเดลที่ถูกต้อง
วิธีแก้ไข: ตรวจสอบชื่อโมเดลและเวอร์ชันโมเดลกับรายการโมเดลทั้งหมดที่ รองรับและพร้อมใช้งาน อย่าลืมตรวจสอบส่วนและลำดับของส่วนในชื่อโมเดล เช่น
- ชื่อGemini 3.x Pro
โมเดล:
gemini-3.1-pro-preview(พร้อมใช้งานในเวอร์ชันตัวอย่างเท่านั้น) - ชื่อโมเดล Gemini 3.x Flash
เวอร์ชันล่าสุด:
gemini-3.7-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 โมเดลเวอร์ชันตัวอย่างและ เวอร์ชันทดลอง: พร้อมใช้งาน ในตำแหน่ง
globalเท่านั้น (ยกเว้นโมเดล Live API - ดูด้านล่าง)Gemini 3.x โมเดล: พร้อมใช้งาน ในตำแหน่ง
globalเท่านั้นเมื่อใช้ Firebase AI Logic Firebase AI Logic ยังไม่ รองรับตำแหน่งusและeuGemini 2.5 โมเดล: พร้อมใช้งานในหลายตำแหน่ง.
Gemini Live API โมเดล: พร้อมใช้งาน ในตำแหน่ง
us-central1เท่านั้น ระบบ ไม่ รองรับตำแหน่งglobal
- เมื่อใช้ไวยากรณ์การเริ่มต้น "Agent Platform":
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธี ระบุตำแหน่งเพื่อเข้าถึงโมเดล (รวมถึงข้อมูลโค้ด)
ข้อผิดพลาด 429: "You exceeded your current quota, please check your plan and billing details" หรือ "Resource exhausted, please try again later."
ข้อผิดพลาดเช่นนี้อาจเกิดขึ้นได้จาก 2 สาเหตุ
คุณใช้โควต้าเกิน หรือโมเดลที่คุณเข้าถึงมี คำขอจากผู้อื่นมากเกินไป
การดำเนินการที่ต้องทำจะขึ้นอยู่กับว่าคุณใช้ 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 เอกสารประกอบเรื่องราคา และ คำถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน