หน้านี้จะอธิบายการแก้ปัญหารหัสข้อผิดพลาดที่พบบ่อยสำหรับ 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.
หากคุณพยายามส่งคำขอแบบหลายโมดัลด้วย URL ของ Cloud Storage for Firebase คุณอาจพบข้อผิดพลาด 400 ต่อไปนี้
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
ข้อผิดพลาดนี้เกิดจากโปรเจ็กต์ที่ไม่มีตัวแทนบริการที่จำเป็นซึ่งจัดสรรอัตโนมัติอย่างถูกต้องเมื่อเปิดใช้ Agent Platform API ในโปรเจ็กต์ ปัญหานี้เป็นปัญหาที่ทราบแล้วซึ่งเกิดขึ้นกับบางโปรเจ็กต์ และเรากำลังดำเนินการแก้ไขทั่วโลก
ต่อไปนี้เป็นวิธีแก้ปัญหาเพื่อแก้ไขโปรเจ็กต์และจัดสรร Service Agent เหล่านี้อย่างถูกต้องเพื่อให้คุณเริ่มรวม URL ของ Cloud Storage for Firebase ไว้ในคำขอแบบหลายโมดัลได้ คุณต้องเป็นเจ้าของโปรเจ็กต์ และต้องทำงานชุดนี้ให้เสร็จสมบูรณ์เพียงครั้งเดียวสำหรับโปรเจ็กต์
เข้าถึงและตรวจสอบสิทธิ์ด้วย gcloud CLI
วิธีที่ง่ายที่สุดในการดำเนินการนี้คือการทำจาก Cloud Shell ดูข้อมูลเพิ่มเติมในเอกสารประกอบของ Google Cloudหากได้รับข้อความแจ้ง ให้ทำตามวิธีการที่แสดงในเทอร์มินัลเพื่อให้ gcloud CLI ทำงานกับโปรเจ็กต์ Firebase
คุณจะต้องใช้รหัสโปรเจ็กต์ Firebase ซึ่งดูได้ที่ด้านบนของsettings การตั้งค่าโปรเจ็กต์ในคอนโซล Firebase
จัดสรร Service 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 ''
รอสักครู่เพื่อให้แน่ใจว่ามีการจัดสรร Service Agent แล้ว จากนั้นลองส่งคำขอแบบหลายโมดัลที่มี URL ของ Cloud Storage for Firebase อีกครั้ง
หากยังคงได้รับข้อผิดพลาดนี้หลังจากรอหลายนาทีแล้ว โปรดติดต่อทีมสนับสนุนของ 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 คุณต้องตรวจสอบว่า API ของ Firebase AI Logic (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: โมเดล "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-3 ประการที่อาจทำให้คุณได้รับข้อผิดพลาดเช่นนี้
ชื่อโมเดลไม่ถูกต้อง
สาเหตุ: ชื่อรุ่นที่คุณระบุไม่ใช่ชื่อรุ่นที่ถูกต้อง
วิธีแก้ไข: ตรวจสอบชื่อและเวอร์ชันของโมเดลกับรายการโมเดลที่รองรับและพร้อมใช้งานทั้งหมด อย่าลืมตรวจสอบกลุ่มและลำดับของกลุ่มในชื่อโมเดล เช่น
- ชื่อโมเดล Gemini 4 Argon ล่าสุด:
gemini-4-argon - ชื่อโมเดล 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 Nano Banana 2.1 ล่าสุด:
gemini-nano-banana-2.1 - ชื่อโมเดล Gemini Nano Banana 2 ล่าสุด:
gemini-3.1-flash-image - ชื่อโมเดล Gemini Nano Banana 2 Lite ล่าสุด:
gemini-3.1-flash-lite-image - ชื่อโมเดล Gemini Nano Banana Pro ล่าสุด:
gemini-3-pro-image
- ชื่อโมเดล Gemini 4 Argon ล่าสุด:
สถานที่ตั้งไม่ถูกต้อง (ใช้ได้เฉพาะเมื่อใช้ผู้ให้บริการ 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เท่านั้นโมเดล Gemini 4.x และ Gemini 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."
มีสาเหตุที่แตกต่างกัน 2-3 ประการที่อาจทำให้คุณได้รับข้อผิดพลาดเช่นนี้
คุณใช้งานเกินโควต้าหรือโมเดลที่คุณเข้าถึงมีคำขอจากผู้อื่นมากเกินไป
การดำเนินการจะขึ้นอยู่กับว่าคุณใช้ 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 แบบจ่ายเมื่อใช้ ตัวอย่างเช่น โมเดลต่อไปนี้มักจะต้องมีการเรียกเก็บเงินเสมอ
- โมเดลเวอร์ชันตัวอย่างและเวอร์ชันทดลองส่วนใหญ่
- โมเดลที่สร้างสื่อ (เช่น โมเดล Gemini Nano Banana)
โมเดลบางรายการมีฟีเจอร์พื้นฐานบางอย่างในGemini Developer API "รุ่นฟรี" แต่ต้องใช้ "รุ่นที่ต้องชำระเงิน" เพื่อใช้ฟีเจอร์ขั้นสูงเพิ่มเติม เช่น
- เมื่อใช้โมเดล Gemini 3.x ส่วนใหญ่
การอ้างอิงข้อมูลด้วย
Google Search หรือGoogle Maps จะต้องมีการเรียกเก็บเงิน
- เมื่อใช้โมเดล Gemini 3.x ส่วนใหญ่
การอ้างอิงข้อมูลด้วย
ดูข้อมูลเกี่ยวกับแพ็กเกจราคาของ Firebase และ Gemini Developer API
ดูรายละเอียดเพิ่มเติมได้ที่Gemini Developer API เอกสารประกอบเกี่ยวกับราคา และ คำถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน