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

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

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

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

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

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

3. จัดเตรียม 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 ''
   

4. รอสักครู่เพื่อให้แน่ใจว่าได้จัดเตรียม Agent บริการแล้ว จากนั้นลองส่งคำขอแบบมัลติโมดัลที่มี Cloud Storage for Firebase URL อีกครั้ง

หากยังคงได้รับข้อผิดพลาดนี้หลังจากรอหลายนาทีแล้ว โปรดติดต่อ ทีมสนับสนุนของ Firebase

ข้อผิดพลาด 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 ของคุณไม่มีการใช้งาน (เช่น คุณ เปิดใช้ Firebase AI Logic แต่ไม่มีการใช้งานล่าสุด)

เมื่อพร้อมที่จะเริ่มใช้ Firebase AI Logic อีกครั้ง ให้ทำดังนี้

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

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

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

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

3. เมื่อพร้อมที่จะเผยแพร่ฟีเจอร์ AI ให้แก่ผู้ใช้ปลายทางแล้ว โปรดตรวจสอบว่า คุณ บังคับใช้ App Check ต่อไป และใช้ผู้ให้บริการการรับรองการใช้งานจริง สำหรับ 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. โดยปกติแล้วจะหมายความว่าการกำหนดค่า 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 เท่านั้น (ยกเว้นโมเดล Live API - ดูด้านล่าง)

    • Gemini 3.x โมเดล: พร้อมใช้งาน ในตำแหน่ง global เท่านั้นเมื่อใช้ Firebase AI Logic Firebase AI Logic ยังไม่ รองรับตำแหน่ง us และ eu

    • Gemini 2.5 โมเดล: พร้อมใช้งานในหลายตำแหน่ง.

    • Gemini Live API โมเดล: พร้อมใช้งาน ในตำแหน่ง us-central1 เท่านั้น ระบบ ไม่ รองรับตำแหน่ง global

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

ข้อผิดพลาด 429: "You exceeded your current quota, please check your plan and billing details" หรือ "Resource exhausted, please try again later."

ข้อผิดพลาด 429 บ่งชี้ว่าคุณใช้โควต้าเกิน หรือโมเดลที่คุณเข้าถึงมีคำขอจากผู้อื่นมากเกินไป

การดำเนินการที่ต้องทำจะขึ้นอยู่กับว่าคุณใช้ Gemini Developer API หรือ Agent Platform Gemini API (formerly Vertex AI) ดูข้อมูลเพิ่มเติมเกี่ยวกับโควต้าและวิธีขอโควต้าเพิ่มเติมได้ที่ ขีดจำกัดอัตราและโควต้า

หากคุณใช้ Agent Platform Gemini API (formerly Vertex AI) เอกสารประกอบ Google Cloud จะให้ข้อมูลเพิ่มเติมและคำแนะนำสำหรับ รหัสข้อผิดพลาด 429