รหัสข้อผิดพลาด

ข้อผิดพลาด 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 ทั้งหมดได้ใน APIs & Services > Credentials แผงในคอนโซล 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 Platform API ใน โปรเจ็กต์ นี่เป็นปัญหาที่ทราบกันดีในบางโปรเจ็กต์ และเรากำลังดำเนินการแก้ไขปัญหานี้ในระดับโลก

วิธีแก้ปัญหาเพื่อแก้ไขโปรเจ็กต์และจัดเตรียมเอเจนต์บริการเหล่านี้อย่างถูกต้องเพื่อให้คุณเริ่มรวม Cloud Storage for Firebase URL ในคำขอแบบมัลติโมดัลได้มีดังนี้ คุณต้องเป็น เจ้าของโปรเจ็กต์ และต้อง ทำชุดงานนี้เพียงครั้งเดียวสำหรับโปรเจ็กต์

1. เข้าถึงและตรวจสอบสิทธิ์ด้วย gcloud CLI
   วิธีที่ง่ายที่สุดคือการดำเนินการจาก Cloud Shell ดูข้อมูลเพิ่มเติมได้ใน Google Cloudเอกสารประกอบ

2. หากได้รับข้อความแจ้ง ให้ทำตามวิธีการที่แสดงในเทอร์มินัลเพื่อทำให้ gcloud CLI ทำงานกับโปรเจ็กต์ Firebase

   คุณจะต้องใช้รหัสโปรเจ็กต์ Firebase ซึ่งดูได้ที่ด้านบนของ settings การตั้งค่าโปรเจ็กต์ ในคอนโซล Firebase

3. จัดเตรียมเอเจนต์บริการที่จำเป็นในโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้

   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 ''
   

4. รอสักครู่เพื่อให้แน่ใจว่าได้จัดเตรียมเอเจนต์บริการแล้ว จากนั้นลองส่งคำขอแบบมัลติโมดัลที่มี 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) เพื่อช่วยปกป้องนักพัฒนาแอปของเรา

หากต้องการเข้าถึงโมเดลที่แสดงข้อผิดพลาด ให้ทำดังนี้

1. ตั้งค่า App Check สำหรับ Firebase AI Logic. สำหรับการพัฒนาในเครื่อง โปรดตรวจสอบว่าคุณได้ตั้งค่า App Check ผู้ให้บริการดีบักแล้ว

   การบังคับใช้ App Check มีความสำคัญอย่างยิ่งในการช่วยปกป้อง Gemini API และ Gemini จากการถูกนำไปใช้ในทางที่ผิด และคุณต้องบังคับใช้เพื่อล้าง ข้อผิดพลาดนี้

2. ส่งคำขอจากแอปไปยัง Firebase AI Logic อีกครั้ง

   คำขอนี้จะส่งโทเค็น App Check ที่ถูกต้องไปด้วย และคุณจะไม่ได้รับข้อผิดพลาด 403 - PERMISSION_DENIED นี้อีกต่อไป

3. ก่อนที่จะเผยแพร่แอปให้ผู้ใช้ปลายทาง คุณต้อง ตั้งค่าผู้ให้บริการการรับรองการติดตั้งใช้งานจริง (เช่น 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 อีกครั้ง ให้ทำดังนี้

1. ตั้งค่า App Check สำหรับ Firebase AI Logic. สำหรับการพัฒนาในเครื่อง โปรดตรวจสอบว่าคุณได้ตั้งค่า App Check ผู้ให้บริการดีบักแล้ว

   การบังคับใช้ App Check มีความสำคัญอย่างยิ่งในการช่วยปกป้อง Gemini API และ Gemini จากการถูกนำไปใช้ในทางที่ผิด และคุณต้องบังคับใช้เพื่อล้าง ข้อผิดพลาดนี้

2. ส่งคำขอจากแอปไปยัง Firebase AI Logic อีกครั้ง

   คำขอนี้จะส่งโทเค็น App Check ที่ถูกต้องไปด้วย และคุณจะไม่ได้รับข้อผิดพลาด 403 - PERMISSION_DENIED นี้อีกต่อไป

3. ก่อนที่จะเผยแพร่แอปให้ผู้ใช้ปลายทาง คุณต้อง ตั้งค่าผู้ให้บริการการรับรองการติดตั้งใช้งานจริง (เช่น 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 ทั้งหมดได้ใน APIs & Services > Credentials แผงในคอนโซล 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

ทำตามขั้นตอนต่อไปนี้

1. ในคอนโซล Google Cloud ให้เปิดแผง APIs & Services > Credentials

2. เลือกคีย์ API ที่แอปพลิเคชันได้รับการกำหนดค่าให้ใช้ (เช่น "คีย์ iOS" สำหรับแอป iOS)

3. ในหน้า Edit API key ให้ค้นหาส่วน API restrictions

4. ตรวจสอบว่าได้เลือกตัวเลือกจำกัดคีย์ แล้ว หากไม่ได้เลือกไว้ แสดงว่าคีย์ของคุณไม่มีการจำกัด และอาจไม่ใช่สาเหตุของข้อผิดพลาด

5. ในเมนูแบบเลื่อนลง Selected APIs ให้ค้นหาและเลือก Firebase AI Logic API เพื่อเพิ่มลงในรายการ API ที่เลือกซึ่งเรียกได้โดยใช้คีย์ API

6. คลิกบันทึก

   ระบบอาจใช้เวลาถึง 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-3 ข้อที่ทำให้คุณได้รับข้อผิดพลาดเช่นนี้

• ชื่อโมเดลไม่ถูกต้อง

  • สาเหตุ: ชื่อโมเดลที่คุณระบุไม่ใช่ชื่อโมเดลที่ถูกต้อง

  • วิธีแก้ไข: ตรวจสอบชื่อโมเดลและเวอร์ชันโมเดลกับรายการโมเดลทั้งหมดที่ รองรับและพร้อมใช้งาน อย่าลืมตรวจสอบส่วนและลำดับของส่วนในชื่อโมเดล เช่น

    • ชื่อ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

• ตำแหน่งไม่ถูกต้อง (ใช้ได้เฉพาะเมื่อใช้ผู้ให้บริการ 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 3.x โมเดลเวอร์ชันเสถียร: พร้อมใช้งาน ในตำแหน่ง global และมักจะพร้อมใช้งานในตำแหน่ง us และ eu

    • Gemini 2.5 โมเดล: พร้อมใช้งานในหลายตำแหน่ง. โปรดทราบว่า Gemini Live API 2.5 โมเดล ไม่พร้อมใช้งานใน global

  ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธี ระบุตำแหน่งเพื่อเข้าถึงโมเดล (รวมถึงข้อมูลโค้ด)

ข้อผิดพลาด 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 แบบจ่ายเมื่อใช้ ตัวอย่างเช่น โมเดลต่อไปนี้เกือบจะต้องมีการเรียกเก็บเงินเสมอ

    • โมเดล เวอร์ชันตัวอย่างและ เวอร์ชันทดลองส่วนใหญ่
    • โมเดลการสร้างรูปภาพ (โมเดล "Nano Banana")

  • โมเดลบางโมเดลมีฟีเจอร์พื้นฐานบางอย่างขณะใช้ Gemini Developer API "รุ่นฟรี" แต่ต้องใช้ "รุ่นแบบชำระเงิน" เพื่อใช้ฟีเจอร์ขั้นสูงเพิ่มเติม เช่น

    • เมื่อใช้โมเดล Gemini 3.x ส่วนใหญ่ การเชื่อมโยงข้อมูลกับ Google Search หรือ Google Maps จะต้องมีการเรียกเก็บเงิน

  ดูข้อมูลเกี่ยวกับ แพ็กเกจราคาของ Firebase และ Gemini Developer API

  ดูรายละเอียดเพิ่มเติมได้ในGemini Developer API เอกสารประกอบเรื่องราคา และ คำถามที่พบบ่อยเกี่ยวกับการเรียกเก็บเงิน