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

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

วิธีแก้ปัญหาเพื่อแก้ไขโปรเจ็กต์และจัดเตรียมเอเจนต์บริการเหล่านี้อย่างถูกต้องเพื่อให้คุณเริ่มรวม 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

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

ข้อผิดพลาด 404: Firebase AI Logic genai config not found

หากพยายามใช้ Gemini Developer API แล้วได้รับข้อผิดพลาด 404 ที่ระบุว่า Firebase AI Logic genai config not found โดยปกติแล้วหมายความว่า โปรเจ็กต์ Firebase ไม่มีคีย์ Gemini API ที่ถูกต้องสำหรับใช้ กับ Firebase AI Logic Client SDK

สาเหตุที่เป็นไปได้มากที่สุดของข้อผิดพลาดนี้มีดังนี้

• คุณยังไม่ได้ตั้งค่าโปรเจ็กต์ Firebase สำหรับ Gemini Developer API

  สิ่งที่ต้องทำ:
  ในคอนโซล Firebase ให้ไปที่ บริการ AI > AI Logic คลิก เริ่มต้นใช้งาน แล้วเลือก Gemini Developer API เปิดใช้ API แล้วคอนโซลจะตั้งค่า โปรเจ็กต์สำหรับ Gemini Developer API หลังจากทำเวิร์กโฟลว์เสร็จแล้ว ให้ลองส่งคำขออีกครั้ง

• หากคุณเพิ่งทำตามเวิร์กโฟลว์การตั้งค่า Firebase AI Logic ในคอนโซล Firebase เมื่อเร็วๆ นี้ คีย์ Gemini API อาจยังไม่พร้อมใช้งาน สำหรับบริการแบ็กเอนด์ที่จำเป็นทั้งหมดในทุกภูมิภาค

  สิ่งที่ต้องทำ:
  รอสักครู่ แล้วลองส่งคำขออีกครั้ง

• คีย์ Gemini API อาจถูกลบออกจาก โปรเจ็กต์ Firebase

  สิ่งที่ต้องทำ:
  ดูวิธี เปลี่ยนคีย์ Gemini API ที่ 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