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