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

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

หากพยายามส่งคำขอแบบมัลติโมดัลด้วย Cloud Storage for Firebase URL คุณอาจพบข้อผิดพลาด 400 ต่อไปนี้
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

ข้อผิดพลาดนี้เกิดจากโปรเจ็กต์ที่ไม่มีตัวแทนบริการที่จำเป็นซึ่งได้รับการจัดสรรโดยอัตโนมัติอย่างถูกต้องเมื่อมีการเปิดใช้ Vertex AI API ในโปรเจ็กต์ ปัญหานี้เป็นปัญหาที่ทราบกันดีในบางโปรเจ็กต์ และเรากำลังดำเนินการแก้ไข ทั่วโลก

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

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

3. ในหน้าแก้ไขคีย์ API ให้ค้นหาส่วนการจำกัด API

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

5. ในเมนูแบบเลื่อนลงAPI ที่เลือก ให้ค้นหาและเลือก 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 ทั้งหมดได้ในแผง API และบริการ > ข้อมูลเข้าสู่ระบบ ในคอนโซล Google Cloud

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

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

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

สาเหตุที่พบบ่อยที่สุดของข้อผิดพลาดนี้มีดังนี้

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

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

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

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

• ระบบอาจลบGeminiคีย์ API ออกจากโปรเจ็กต์ Firebase ของคุณ

  สิ่งที่ต้องทำ
  ดูวิธีเปลี่ยนคีย์ API Gemini ที่ 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-pro-image-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."

คุณอาจได้รับข้อผิดพลาดเช่นนี้เนื่องจากสาเหตุต่างๆ

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

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

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

    • ชื่อรุ่น Gemini 3.x Pro ล่าสุด gemini-3.1-pro-preview (พร้อมใช้งานในเวอร์ชันตัวอย่างเท่านั้น)
    • ชื่อรุ่น Gemini 3.x Flashล่าสุด gemini-3.5-flash
    • ชื่อรุ่น Gemini 3.x Flash‑Liteล่าสุด gemini-3.1-flash-lite
    • ชื่อโมเดล Gemini 3.x Pro Image ล่าสุด (หรือที่เรียกว่า "Nano Banana Pro") gemini-3-pro-image-preview (พร้อมให้บริการในเวอร์ชันตัวอย่างเท่านั้น)
    • ชื่อโมเดล Gemini 3.x Flash Image (หรือที่เรียกว่า "Nano Banana 2") ล่าสุด gemini-3.1-flash-image-preview (พร้อมให้บริการในเวอร์ชันตัวอย่างเท่านั้น)
    • ชื่อโมเดล "Nano Banana" ล่าสุด gemini-2.5-flash-image

• สถานที่ตั้งไม่ถูกต้อง (ใช้ได้เฉพาะในกรณีที่ใช้ผู้ให้บริการ Vertex AI Gemini API)

  • สาเหตุ: คำขอแต่ละรายการที่ใช้ Vertex AI Gemini API ต้องมีตำแหน่งเพื่อเข้าถึงโมเดล คำขอของคุณอาจพยายาม เข้าถึงโมเดลในสถานที่ที่โมเดลไม่พร้อมใช้งาน

  • วิธีแก้: ตรวจสอบว่าคำขอของคุณพยายามเข้าถึงโมเดลที่พร้อมใช้งาน

    เมื่อใช้ Vertex AI Gemini API Firebase AI Logic ค่าเริ่มต้นจะเป็น us-central1 อย่างไรก็ตาม us-central1 ไม่รองรับบางรุ่น ซึ่งหมายความว่าคุณอาจต้อง ตั้งค่าตำแหน่งที่เฉพาะเจาะจงอย่างชัดเจนในระหว่างการเริ่มต้น ทั้งนี้ขึ้นอยู่กับรุ่น

    • Gemini โมเดลตัวอย่างและเวอร์ชันทดลอง: ต้องตั้งค่าสถานที่เป็น global (ยกเว้นโมเดล Live API) โมเดลGeminiทั้งหมดในเวอร์ชันตัวอย่างและเวอร์ชันทดลอง (ยกเว้นโมเดล Live API ) จะพร้อมให้บริการเฉพาะในสถานที่ตั้งglobal

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

    • Gemini 2.5 รุ่น: การตั้งค่าตำแหน่ง เป็นตัวเลือก หากไม่ได้ระบุตำแหน่ง ค่าเริ่มต้นจะเป็น us-central1

    • 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 หรือ Vertex AI Gemini API ดูข้อมูลเพิ่มเติมเกี่ยวกับโควต้าและวิธีขอโควต้าเพิ่มเติมได้ที่ขีดจำกัดอัตราและโควต้า

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