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

ข้อผิดพลาด 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 บริการที่จำเป็น โดยอัตโนมัติอย่างถูกต้องเมื่อเปิดใช้ Vertex AI 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: 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-pro-image-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.1 Pro คือ gemini-3.1-pro-preview
    • ชื่อโมเดลตัวอย่าง Gemini 3 Flash คือ gemini-3-flash-preview
    • ชื่อโมเดลตัวอย่าง "Nano Banana Pro" คือ gemini-3-pro-image-preview
    • ชื่อโมเดลตัวอย่าง "Nano Banana 2" คือ gemini-3.1-flash-image-preview
    • ชื่อโมเดล "Nano Banana" คือ gemini-2.5-flash-image

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

  • สาเหตุ: คุณใช้โมเดลเวอร์ชัน ตัวอย่าง หรือ ทดลอง (เช่น gemini-3.1-pro-preview และ gemini-3.1-flash-image-preview) และไม่ได้ระบุสถานที่ตั้ง global

    หากใช้ Vertex AI Gemini API โมเดล ตัวอย่าง และ ทดลอง Gemini ทั้งหมด (ยกเว้นโมเดล Gemini Live) จะพร้อมใช้งานในสถานที่ตั้ง global เท่านั้น อย่างไรก็ตาม เนื่องจาก Firebase AI Logic จะใช้สถานที่ตั้ง us-central1 เป็นค่าเริ่มต้น คุณจึงต้อง ระบุสถานที่ตั้ง global อย่างชัดเจนเมื่อเริ่มต้นบริการแบ็กเอนด์ Vertex AI Gemini API ในโค้ดเมื่อใช้โมเดล ตัวอย่าง และ ทดลอง Gemini เหล่านี้

  • วิธีแก้ไข: เมื่อเริ่มต้นบริการ Vertex AI Gemini API ให้ระบุสถานที่ตั้ง global ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธี ระบุสถานที่ตั้งสำหรับการเข้าถึงโมเดล (รวมถึงข้อมูลโค้ด)

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

  • สาเหตุ: คุณใช้โมเดลที่ไม่รองรับในสถานที่ตั้งที่คุณ พยายามเข้าถึง

    หากใช้ Vertex AI Gemini API, โมเดลบางรายการจะพร้อมใช้งานในสถานที่ตั้งที่เฉพาะเจาะจงเท่านั้น เช่น (แต่ไม่จำกัดเพียง)

    • โมเดล Imagen ไม่ รองรับในสถานที่ตั้ง global
    • Gemini Live API โมเดล (เช่น gemini-2.0-flash-live-preview-04-09) รองรับในสถานที่ตั้ง us-central1 เท่านั้น
    • โมเดล Gemini 2.5 (เช่น gemini-2.5-pro) พร้อมใช้งานในสถานที่ตั้ง global สถานที่ตั้งในสหรัฐอเมริกา และสถานที่ตั้งบางแห่งในยุโรป เท่านั้น (และบางครั้งในสถานที่ตั้งอื่นๆ หากโปรเจ็กต์มีตัวเลือกพิเศษ)

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

    โปรดทราบว่า Firebase AI Logic จะใช้สถานที่ตั้ง us-central1 เป็นค่าเริ่มต้น

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