หน้านี้จะแสดงการแก้ปัญหารหัสข้อผิดพลาดที่พบบ่อยสำหรับ Gemini API และ Firebase AI Logic SDK
ข้อผิดพลาด 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 ในคำขอแบบมัลติโมดัลได้มีดังนี้ คุณต้องเป็น เจ้าของโปรเจ็กต์ และทำชุดงานนี้เพียงครั้งเดียวสำหรับโปรเจ็กต์
เข้าถึงและตรวจสอบสิทธิ์ด้วย gcloud CLI
วิธีที่ง่ายที่สุดคือทำจาก Cloud Shell ดูข้อมูลเพิ่มเติมได้ใน Google Cloudเอกสารประกอบหากได้รับข้อความแจ้ง ให้ทำตามวิธีการที่แสดงในเทอร์มินัลเพื่อทำให้ gcloud CLI ทำงานกับโปรเจ็กต์ Firebase
คุณจะต้องใช้รหัสโปรเจ็กต์ Firebase ซึ่งดูได้ที่ด้านบนของ settings การตั้งค่าโปรเจ็กต์ ในคอนโซล Firebase
จัดเตรียม 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 ''
รอสักครู่เพื่อให้แน่ใจว่าได้จัดเตรียม 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
ทำตามขั้นตอนต่อไปนี้
ในคอนโซล Google Cloud ให้เปิดแผง APIs & Services > Credentials
เลือกคีย์ API ที่แอปพลิเคชันได้รับการกำหนดค่าให้ใช้ (เช่น "คีย์ iOS" สำหรับแอป iOS)
ในหน้า Edit API key ให้ค้นหาส่วน API restrictions
ตรวจสอบว่าได้เลือกตัวเลือกจำกัดคีย์ แล้ว หากไม่ได้เลือก แสดงว่าคีย์ของคุณไม่มีข้อจำกัด และอาจไม่ใช่สาเหตุของข้อผิดพลาด
ในเมนูแบบเลื่อนลง Selected APIs ให้ค้นหาและเลือก Firebase AI Logic API เพื่อเพิ่มลงในรายการ API ที่เลือกซึ่งเรียกได้โดยใช้คีย์ API
คลิกบันทึก
ระบบอาจใช้เวลาถึง 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
- ชื่อโมเดลตัวอย่าง Gemini 3.1 Pro คือ
สถานที่ตั้งไม่ถูกต้อง (ใช้ได้เฉพาะเมื่อใช้ผู้ให้บริการ 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-central1globalอย่างชัดเจนเมื่อเริ่มต้นบริการแบ็กเอนด์ 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สถานที่ตั้งในสหรัฐอเมริกา และสถานที่ตั้งบางแห่งในยุโรป เท่านั้น (และบางครั้งในสถานที่ตั้งอื่นๆ หากโปรเจ็กต์มีตัวเลือกพิเศษ)
- โมเดล Imagen ไม่ รองรับในสถานที่ตั้ง
วิธีแก้ไข: เมื่อเริ่มต้นบริการ 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