หน้านี้จะอธิบายการแก้ปัญหารหัสข้อผิดพลาดที่พบบ่อยสำหรับ SDK ของ Gemini API และ Firebase AI Logic
ข้อผิดพลาด 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 ในคำขอแบบมัลติโมดัลได้ คุณต้องเป็นเจ้าของโปรเจ็กต์ และคุณต้องทำชุดงานนี้เพียงครั้งเดียวสำหรับโปรเจ็กต์
เข้าถึงและตรวจสอบสิทธิ์ด้วย 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 ''
รอสักครู่เพื่อให้ระบบจัดสรรตัวแทนบริการ แล้วลองส่งคำขอแบบมัลติโมดัลอีกครั้งซึ่งมี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คอนโซล ให้เปิดแผง API และบริการ > ข้อมูลเข้าสู่ระบบ
เลือกคีย์ API ที่กำหนดค่าแอปพลิเคชันให้ใช้ (เช่น "คีย์ iOS" สำหรับแอป iOS)
ในหน้าแก้ไขคีย์ API ให้ค้นหาส่วนการจำกัด API
ตรวจสอบว่าได้เลือกตัวเลือกจำกัดคีย์แล้ว หากไม่ได้ระบุไว้ แสดงว่าคีย์ของคุณ ไม่มีข้อจำกัด และไม่น่าจะเป็นสาเหตุของข้อผิดพลาด
ในเมนูแบบเลื่อนลงAPI ที่เลือก ให้ค้นหาและเลือก 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 ทั้งหมดได้ในแผง 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
- 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 เอกสารประกอบของ Vertex AI Gemini API จะให้บริบทและคำแนะนำเพิ่มเติมสำหรับ รหัสข้อผิดพลาด 429Google Cloud