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

ข้อผิดพลาด 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

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

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

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: 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 นาทีเพื่อให้การเปลี่ยนแปลงมีผล

ข้อผิดพลาด 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

หากพบว่าคีย์ไม่ตรงกัน ให้ รับไฟล์/ออบเจ็กต์การกำหนดค่า Firebase ใหม่, แล้ว แทนที่ ไฟล์/ออบเจ็กต์ที่มีอยู่ในแอป ไฟล์/ออบเจ็กต์การกำหนดค่าใหม่ ควรมีคีย์ API ที่ถูกต้องสำหรับแอปและโปรเจ็กต์ Firebase

ข้อผิดพลาด 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.6-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