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

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

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

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

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

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 Logic ในคอนโซล Firebase คลิกเริ่มต้นใช้งาน แล้วเลือก Gemini Developer API เปิดใช้ API แล้วคอนโซลจะตั้งค่าโปรเจ็กต์สำหรับ Gemini Developer API หลังจากเวิร์กโฟลว์เสร็จสมบูรณ์แล้ว ให้ลองส่งคำขออีกครั้ง

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

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

• ระบบอาจลบคีย์ API Gemini ออกจากโปรเจ็กต์ 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.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 เอกสารประกอบของ Vertex AI Gemini API จะให้บริบทและคำแนะนำเพิ่มเติมสำหรับ รหัสข้อผิดพลาด 429Google Cloud