หน้านี้จะให้คำตอบสำหรับคำถามที่พบบ่อย (FAQ) และข้อมูลการแก้ปัญหาเกี่ยวกับ Gemini API และ Firebase AI Logic SDK หากมีคำถามเพิ่มเติม โปรดดูคำถามที่พบบ่อยเกี่ยวกับ Gemini API ในเอกสารประกอบของ Google Cloud
คำถามที่พบบ่อยทั่วไป
ทำไมชื่อจึงเปลี่ยนจาก "Vertex AI ใน Firebase" เป็น "Firebase AI Logic"
ย้อนกลับไปเมื่อปี 2024 เราได้เปิดตัวชุด SDK ของไคลเอ็นต์ Firebase ที่ใช้ Vertex AI Gemini API ได้ รวมถึงพร็อกซีเกตเวย์ Firebase เพื่อปกป้อง API ดังกล่าวจากการละเมิดและเพื่อเปิดใช้การผสานรวมกับผลิตภัณฑ์อื่นๆ ของ Firebase เราเรียกผลิตภัณฑ์ของเราว่า "Vertex AI ใน Firebase" และชื่อผลิตภัณฑ์นี้อธิบายกรณีการใช้งานที่มีของผลิตภัณฑ์ได้อย่างถูกต้อง ณ ขณะนั้น
แต่ตั้งแต่นั้นมา เราได้ขยายความสามารถของผลิตภัณฑ์ ตัวอย่างเช่น ในเดือนพฤษภาคม 2025 เราได้เริ่มรองรับ Gemini Developer API แล้ว ซึ่งรวมถึงความสามารถในการปกป้อง Gemini Developer API จากการละเมิดโดยใช้การผสานรวมกับ Firebase App Check
ด้วยเหตุนี้ ชื่อ "Vertex AI ใน Firebase" จึงไม่ได้แสดงถึงขอบเขตที่ขยายการให้บริการของผลิตภัณฑ์อย่างถูกต้องแล้ว ด้วยเหตุนี้ ชื่อใหม่อย่าง Firebase AI Logic จึงสื่อถึงชุดฟีเจอร์ที่พัฒนาอย่างต่อเนื่องของเราได้ดียิ่งขึ้น และช่วยให้เราขยายการให้บริการต่อไปได้ในอนาคต
โปรดดูคู่มือการย้ายข้อมูลเพื่อให้แน่ใจว่าคุณได้รับฟีเจอร์ล่าสุดทั้งหมดจาก Firebase AI Logic (และเริ่มใช้ Gemini Developer API หากต้องการ)
การใช้ Gemini Developer API กับ Vertex AI Gemini API แตกต่างกันอย่างไร
ความแตกต่างบางอย่างระหว่างผู้ให้บริการ "Gemini API" 2 รายมีดังนี้ โดยทั่วไป ไม่ว่าคุณจะเข้าถึงผู้ให้บริการรายใด
-
Gemini Developer API มี "แพ็กเกจไม่มีค่าใช้จ่าย" พร้อมกับราคาแบบจ่ายตามการใช้งาน
Vertex AI Gemini API เมื่อใช้กับ Firebase AI Logic ต้องใช้แพ็กเกจราคาแบบจ่ายเมื่อใช้ Blaze เสมอ
โปรดทราบว่าผู้ให้บริการ API ทั้ง 2 รายมีราคาแบบจ่ายตามการใช้งานที่แตกต่างกัน (ดูข้อมูลเพิ่มเติมในเอกสารประกอบที่เกี่ยวข้อง)
-
Gemini Developer API มีการจำกัดอัตราอย่างชัดเจน
Vertex AI Gemini API ใช้ "โควต้าที่แชร์แบบไดนามิก (DSQ)" ที่ทุกคนที่ใช้รูปแบบนั้นในภูมิภาคนั้นใช้ร่วมกัน นอกจากนี้ คุณยังตั้งค่าอัตราการส่งผ่านที่จัดสรร (PT) ได้ด้วย (ไม่บังคับ)
การระบุตำแหน่งสำหรับการเข้าถึงโมเดล
- เฉพาะ Vertex AI Gemini API เท่านั้นที่ให้คุณเลือกตำแหน่งที่จะเข้าถึงโมเดล
ตารางต่อไปนี้แสดงความพร้อมใช้งานของฟีเจอร์ที่พบบ่อยสำหรับผู้ให้บริการ "Gemini API" 2 ราย ตารางนี้ใช้เฉพาะเมื่อใช้Firebase AI Logic SDK ของไคลเอ็นต์
ฟีเจอร์ | Gemini Developer API | Vertex AI Gemini API |
---|---|---|
การรองรับรุ่น Gemini | รองรับGeminiทุกรุ่น | รองรับGeminiทุกรุ่น |
การรองรับรุ่น Imagen |
รุ่น Imagen 3 ที่รองรับ
(ยังไม่รองรับ Unity) |
รุ่น Imagen 3 ที่รองรับ
(ยังไม่รองรับ Unity) |
การรองรับรุ่น Veo | ยังไม่รองรับ | ยังไม่รองรับ |
การสร้างรูปภาพโดยใช้โมเดล Gemini | รองรับ | รองรับ |
การรองรับ Gemini Live API | ยังไม่รองรับ |
รองรับ
(Android, Flutter และ Unity เท่านั้น) |
การผสานรวมกับ Firebase App Check | รองรับ | รองรับ |
เข้ากันได้กับ Firebase Remote Config | รองรับ | รองรับ |
การรองรับการตรวจสอบ AI ในคอนโซล Firebase | ยังไม่รองรับ | รองรับ |
การรองรับ URL Cloud Storage | ยังไม่รองรับ 1 |
ไฟล์สาธารณะและ ไฟล์ที่ได้รับการปกป้องโดย Firebase Security Rules |
การรองรับ URL ของ YouTube และ URL ของเบราว์เซอร์ | URL ของ YouTube เท่านั้น | URL ของ YouTube และ URL ของเบราว์เซอร์ |
1 Gemini Developer API ไม่รองรับ Files API ผ่าน Firebase AI Logic SDK
ฉันจะใช้ทั้ง Gemini Developer API และ Vertex AI Gemini API ได้ไหม
ได้ คุณสามารถเปิดใช้ผู้ให้บริการ "Gemini API" ทั้ง 2 รายในโปรเจ็กต์ Firebase และสามารถใช้ทั้ง 2 API ในแอปได้
หากต้องการสลับระหว่างผู้ให้บริการ API ในโค้ด เพียงตรวจสอบว่าคุณได้ตั้งค่าบริการแบ็กเอนด์อย่างเหมาะสมในโค้ด
API ที่จำเป็นมีอะไรบ้าง และฉันจะเปิดใช้ได้อย่างไร
เลือกผู้ให้บริการ Gemini API เพื่อดูเนื้อหาเฉพาะของผู้ให้บริการ |
หากต้องการใช้ Firebase AI Logic SDK กับ Gemini Developer API โปรเจ็กต์ของคุณต้องเปิดใช้ API 2 รายการต่อไปนี้
- Gemini Developer API (
generativelanguage.googleapis.com
) - Firebase AI Logic API (
firebasevertexai.googleapis.com
)
คุณควรเปิดใช้ API 2 รายการนี้โดยใช้คอนโซล Firebase
ในคอนโซล Firebase ให้ไปที่หน้า Firebase AI Logic
คลิกเริ่มต้นใช้งาน
เลือกเพื่อเริ่มต้นใช้งาน Gemini Developer API
ซึ่งจะเปิดเวิร์กโฟลว์แบบมีคําแนะนําซึ่งเปิดใช้ API 2 รายการให้คุณ คอนโซลจะสร้างคีย์ Gemini API รวมถึงเพิ่ม Firebase AI Logic API ลงในรายการที่อนุญาตสำหรับคีย์ Firebase API ด้วย
โมเดลใดบ้างที่ใช้กับ Firebase AI Logic SDK ได้
คุณสามารถใช้โมเดลฐาน Gemini และ Imagen 3 กับ Firebase AI Logic SDK ได้ทุกรุ่น รวมถึงเวอร์ชันตัวอย่างและเวอร์ชันทดลอง ดูรายการรุ่นเหล่านี้ได้ในหัวข้อดูข้อมูลเกี่ยวกับรุ่นที่รองรับ
คุณไม่สามารถใช้โมเดล Gemini ที่ไม่ใช่พื้นฐาน (เช่น โมเดล PaLM, โมเดลที่ปรับแต่ง หรือโมเดลที่อิงตาม Gemma) กับ Firebase AI LogicSDK
นอกจากนี้ Firebase AI Logic ยังไม่รองรับ Imagen รุ่นเก่าหรือ
imagen-3.0-capability-001
Gemini Developer API (ไม่ว่าจะเข้าถึงด้วยวิธีใด) ไม่รองรับ
imagen-3.0-fast-generate-001
หรือimagen-3.0-generate-001
เวอร์ชันเก่ากว่า
เราเพิ่มความสามารถใหม่ๆ ลงใน SDK อยู่บ่อยครั้ง ดังนั้นโปรดกลับมาดูคำถามที่พบบ่อยนี้เพื่อดูข้อมูลอัปเดต (รวมถึงในบันทึกประจำรุ่น บล็อก และโพสต์โซเชียล)
สิ่งที่ต้องทำเมื่อรุ่นต่างๆ หยุดให้บริการ
เมื่อเผยแพร่โมเดลเวอร์ชันเสถียร เราจะพยายามทำให้โมเดลดังกล่าวพร้อมใช้งานเป็นอย่างน้อย 1 ปี เราได้ระบุ "วันที่หยุดให้บริการ" นี้ไว้หลายที่ในเอกสารประกอบของ Firebase และ Google Cloud (เช่น ในหน้า"รูปแบบ")
เมื่อเลิกใช้งานโมเดลแล้ว คำขอใดก็ตามสำหรับโมเดลนั้นจะดำเนินการไม่สำเร็จพร้อมกับแสดงข้อผิดพลาด 404 ด้วยเหตุนี้ เราจึงขอแนะนําอย่างยิ่งให้ตั้งค่าและใช้ Firebase Remote Config เพื่อให้คุณเปลี่ยนแปลงโมเดลและเวอร์ชันในแอปแบบไดนามิกได้โดยไม่ต้องเผยแพร่แอปเวอร์ชันใหม่
เมื่ออัปเดตแอปให้ใช้โมเดลเวอร์ชันใหม่ เราขอแนะนำให้ทดสอบแอปเพื่อให้แน่ใจว่าการตอบกลับยังคงเป็นไปตามที่คาดไว้ โปรดทราบว่าเมื่อใช้ Firebase AI Logic โดยทั่วไปแล้ว ไม่จำเป็นต้องแก้ไขโค้ดใดๆ ที่เรียกใช้โมเดล
วันที่หยุดให้บริการของรุ่นต่างๆ มีดังนี้
Gemini 1.5 Pro รุ่น:
gemini-1.5-pro-002
(และgemini-1.5-pro
): 24 กันยายน 2025gemini-1.5-pro-001
: 24 พฤษภาคม 2025
Gemini 1.5 Flash รุ่น:
gemini-1.5-flash-002
(และgemini-1.5-flash
): 24 กันยายน 2025gemini-1.5-flash-001
: 24 พฤษภาคม 2025
Gemini 1.0 Pro Vision: 21 เมษายน 2025 (ก่อนหน้านี้กำหนดไว้เป็นวันที่ 9 เมษายน 2025)
Gemini 1.0 Pro: 21 เมษายน 2025 (ก่อนหน้านี้กำหนดไว้เป็นวันที่ 9 เมษายน 2025)
ฉันจะตั้งค่าขีดจำกัดของอัตราต่อผู้ใช้ได้อย่างไร
โดยค่าเริ่มต้น Firebase AI Logic จะกำหนดขีดจำกัดคำขอต่อผู้ใช้ไว้ที่ 100 คำขอต่อนาที (RPM)
หากต้องการปรับขีดจำกัดอัตราต่อผู้ใช้ คุณต้องปรับการตั้งค่าโควต้าสำหรับ Firebase AI Logic API
ดูข้อมูลเพิ่มเติมเกี่ยวกับFirebase AI Logic โควต้า API ในหน้าดังกล่าว คุณยังดูวิธีดูและแก้ไขโควต้าได้ด้วย
ต้องใช้สิทธิ์ใดบ้างในการใช้ Firebase AI Logic SDK
การดำเนินการ | สิทธิ์ IAM ที่จําเป็น | บทบาท IAM ที่มีสิทธิ์ที่จําเป็นโดยค่าเริ่มต้น |
---|---|---|
อัปเกรดการเรียกเก็บเงินเป็นแพ็กเกจราคาแบบจ่ายเมื่อใช้ (Blaze) | firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment
|
เจ้าของ |
เปิดใช้ API ในโปรเจ็กต์ | serviceusage.services.enable |
เอดิเตอร์ เจ้าของ |
สร้างแอป Firebase | firebase.clients.create |
ผู้ดูแลระบบ Firebase ผู้แก้ไข เจ้าของ |
Firebase AI Logic ใช้ข้อมูลของฉันเพื่อฝึกโมเดลไหม
ฉันต้องใช้ประเภท MIME ในคำขอแบบหลายรูปแบบไหม (เช่น สำหรับอินพุตรูปภาพ, PDF, วิดีโอ และเสียง)
ใช่ ในคำขอแบบมัลติโมเดลแต่ละรายการ คุณต้องระบุข้อมูลต่อไปนี้เสมอ
mimeType
ของไฟล์ ดูข้อยกเว้นด้านล่างไฟล์ คุณสามารถระบุไฟล์เป็นข้อมูลในหน้าหรือระบุไฟล์โดยใช้ URL ของไฟล์ก็ได้
ดูข้อมูลเกี่ยวกับประเภทไฟล์อินพุตที่รองรับ วิธีระบุประเภท MIME และ 2 ตัวเลือกในการส่งไฟล์ในไฟล์อินพุตและข้อกำหนดที่รองรับ
ข้อยกเว้นในการระบุประเภท MIME ในคำขอ
ข้อยกเว้นในการระบุประเภท MIME คืออินพุตรูปภาพในบรรทัดสําหรับคําขอจากแอปแพลตฟอร์ม Android และ Apple ดั้งเดิม
Firebase AI Logic SDK สําหรับแพลตฟอร์ม Android และ Apple มีวิธีจัดการรูปภาพในคําขอที่เรียบง่ายและเหมาะกับแพลตฟอร์ม โดยระบบจะแปลงรูปภาพทั้งหมด (ไม่ว่ารูปแบบใดก็ตาม) เป็น JPEG ที่คุณภาพ 80% ฝั่งไคลเอ็นต์ก่อนที่จะส่งไปยังเซิร์ฟเวอร์ ซึ่งหมายความว่าเมื่อคุณระบุรูปภาพเป็นข้อมูลในบรรทัดโดยใช้ SDK ของแพลตฟอร์ม Android และ Apple คุณไม่จำเป็นต้องระบุประเภท MIME ในคำขอ
การจัดการที่ง่ายขึ้นนี้แสดงอยู่ในFirebase AI Logicเอกสารประกอบในตัวอย่างการส่งรูปภาพที่เข้ารหัสฐาน 64 ในคําขอ
ข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้สำหรับแต่ละแพลตฟอร์มมีดังนี้
สำหรับ Android
คุณใช้ประโยชน์จากวิธีจัดการประเภทรูปภาพ (
Bitmap
) ของแพลตฟอร์มแบบง่ายในพรอมต์แบบหลายรูปแบบที่มีรูปภาพเป็นข้อมูลในบรรทัด (ดูตัวอย่าง)หากต้องการควบคุมรูปแบบและการเปลี่ยนรูปแบบรูปภาพได้มากขึ้น คุณสามารถระบุรูปภาพเป็น
InlineDataPart
และระบุประเภท MIME ที่เฉพาะเจาะจง เช่นcontent { inlineData(/* PNG as byte array */, "image/png") }
สำหรับแพลตฟอร์ม Apple
คุณใช้ประโยชน์จากวิธีจัดการประเภทรูปภาพแบบเนทีฟของแพลตฟอร์ม (
UIImage
,NSImage
,CIImage
และCGImage
) ในพรอมต์แบบมัลติโมเดลที่มีรูปภาพเป็นข้อมูลในบรรทัดได้ (ดูตัวอย่าง)หากต้องการควบคุมรูปแบบและการเปลี่ยนรูปแบบรูปภาพได้มากขึ้น คุณสามารถระบุรูปภาพเป็น
InlineDataPart
และระบุประเภท MIME ที่เฉพาะเจาะจง เช่นInlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")
ฟีเจอร์เหล่านี้พร้อมใช้งานเมื่อใช้ Firebase AI Logic ไหม การแคชบริบท เครื่องมือค้นหา การสร้างรากฐานด้วย Google Search การดำเนินการกับโค้ด การปรับแต่งโมเดลอย่างละเอียด การสร้างการฝัง และการจัดเก็บคําตามความหมาย
โมเดลต่างๆ หรือ Vertex AI Gemini API รองรับการแคชบริบท การใช้ Search เป็นเครื่องมือ การเชื่อมโยงกับ Google Search การดำเนินการโค้ด การจํากัดความแม่นยําของโมเดล การสร้างการฝัง และการจัดทําดัชนีตามความหมาย แต่จะไม่พร้อมใช้งานเมื่อใช้ Firebase AI Logic
หากต้องการเพิ่มฟีเจอร์เหล่านี้เป็นคําขอฟีเจอร์หรือลงคะแนนในคําขอฟีเจอร์ที่มีอยู่ โปรดไปที่ Firebase UserVoice
Gemini คำถามที่พบบ่อยเกี่ยวกับคีย์ API
คําถามที่พบบ่อยเหล่านี้ใช้ได้ในกรณีที่คุณใช้ Gemini Developer API เท่านั้น
คีย์ Gemini API คืออะไร
Gemini Developer API ใช้ "คีย์ Gemini API" เพื่อให้สิทธิ์ผู้โทร ดังนั้น หากคุณใช้ Gemini Developer API ผ่าน Firebase AI LogicSDK คุณจะต้องมีGeminiคีย์ API ที่ถูกต้องในโปรเจ็กต์ Firebase เพื่อเรียก API นั้น
"Gemini คีย์ API" หมายถึงคีย์ API ที่มี Gemini Developer API ในรายการที่อนุญาตของ API
เมื่อคุณทำตามเวิร์กโฟลว์การตั้งค่า Firebase AI Logic ในคอนโซล Firebase เราจะสร้างคีย์ API ของ Gemini ที่จำกัดไว้สำหรับ Gemini Developer API เท่านั้น และตั้งค่าบริการพร็อกซี Firebase AI Logic เพื่อใช้คีย์ API นี้ คีย์ Gemini API ที่ Firebase สร้างขึ้นนี้มีชื่อว่าคีย์ API ของนักพัฒนาแอป Gemini (สร้างขึ้นโดย Firebase โดยอัตโนมัติ) ในหน้าข้อมูลเข้าสู่ระบบของคอนโซล Google Cloud
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจํากัด API สําหรับคีย์ API
คุณไม่เพิ่มคีย์ Gemini API ลงในโค้ดเบสของแอปเมื่อใช้ Firebase AI Logic SDK ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีรักษาคีย์ Gemini API ให้ปลอดภัย
ฉันควรเพิ่มGeminiคีย์ API ลงในโค้ดเบสของแอปบนอุปกรณ์เคลื่อนที่หรือเว็บแอปไหม
เมื่อใช้ Firebase AI Logic SDK โปรดอย่าเพิ่มGeminiคีย์ API ลงในโค้ดเบสของแอป
อันที่จริงแล้ว ขณะพัฒนาด้วย Firebase AI Logic SDK คุณจะไม่ได้โต้ตอบกับคีย์ Gemini API โดยตรง แต่เราจะใส่Geminiคีย์ API ไว้ในคำขอแต่ละรายการที่ส่งไปยัง Gemini Developer API ทางแบ็กเอนด์แทน ซึ่งจะดำเนินการทั้งหมดในแบ็กเอนด์Firebase AI Logic
ฉันจะเปลี่ยนคีย์ Gemini API ที่ใช้เรียก Gemini Developer API ได้อย่างไร
เมื่อใช้ Firebase AI Logic SDK คุณไม่จําเป็นต้องเปลี่ยนคีย์ Gemini API อย่างไรก็ตาม ต่อไปนี้คือ 2 กรณีที่คุณอาจต้องดำเนินการ
หากคุณเปิดเผยคีย์โดยไม่ตั้งใจและต้องการแทนที่ด้วยคีย์ใหม่ที่มีความปลอดภัย
หากคุณลบคีย์โดยไม่ตั้งใจ โปรดทราบว่าคุณสามารถยกเลิกการลบคีย์ได้ภายใน 30 วันนับจากวันที่ลบ
วิธีเปลี่ยนคีย์ Gemini API ที่ Firebase AI Logic SDK ใช้มีดังนี้
หากคีย์ Gemini API ที่ Firebase สร้างขึ้นยังคงอยู่ ให้ลบคีย์นั้น
คุณลบคีย์ API นี้ได้ในแผงAPI และบริการ > ข้อมูลเข้าสู่ระบบ ของคอนโซล Google Cloud คีย์นี้มีชื่อว่า
คีย์ API ของนักพัฒนาแอป Gemini (สร้างโดย Firebase โดยอัตโนมัติ)ในหน้าเดียวกันของGoogle Cloudคอนโซล ให้สร้างคีย์ API ใหม่ เราขอแนะนำให้ตั้งชื่อเป็นอย่าง
คีย์ API ของนักพัฒนาแอป Gemini สำหรับ Firebaseเพิ่มข้อจำกัด API ให้กับคีย์ API ใหม่นี้ และเลือกเฉพาะ Generative Language API
บางครั้ง Gemini Developer API เรียกในคอนโซล Google Cloud ว่า "Generative Language API"อย่าเพิ่มการจํากัดแอป มิเช่นนั้นบริการพร็อกซี Firebase AI Logic จะไม่ทํางานตามที่คาดไว้
เรียกใช้คําสั่งต่อไปนี้เพื่อตั้งค่าคีย์ใหม่นี้เป็นGeminiคีย์ API ที่Firebase AI Logicบริการพร็อกซีควรใช้
PROJECT_ID="PROJECT_ID" GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY" curl \ -X PATCH \ -H "x-goog-user-project: ${PROJECT_ID}" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \ -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
ดูข้อมูลเกี่ยวกับ gcloud CLI
โปรดอย่าเพิ่มคีย์ Gemini API ใหม่นี้ลงในฐานโค้ดของแอป ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีรักษาคีย์ Gemini API ให้ปลอดภัย
ฉันจะใช้ "คีย์ Firebase API" เป็นคีย์ Gemini API ได้ไหม
ไม่ คุณไม่ควรใช้ "คีย์ API ของ Firebase" เป็นคีย์ API ของ Gemini เราขอแนะนําอย่างยิ่งให้คุณไม่เพิ่ม Gemini Developer API ลงในรายการที่อนุญาตสําหรับคีย์ Firebase API
คีย์ Firebase API คือคีย์ API ที่แสดงอยู่ในไฟล์หรือออบเจ็กต์การกําหนดค่า Firebase ที่คุณเพิ่มลงในโค้ดเบสของแอปเพื่อเชื่อมต่อแอปกับ Firebase คุณใส่คีย์ Firebase API ไว้ในโค้ดได้เมื่อใช้คีย์กับ API ที่เกี่ยวข้องกับ Firebase เท่านั้น (เช่น Firebase AI Logic) ดูข้อมูลสำคัญเกี่ยวกับคีย์ Firebase API
ในแผงAPI และบริการ > ข้อมูลเข้าสู่ระบบ ของคอนโซล Google Cloud คีย์ Firebase API จะมีหน้าตาดังนี้
เนื่องจากคุณต้องเพิ่มคีย์ API ของ Firebase ลงในโค้ดเบสของแอปเพื่อให้ API ที่เกี่ยวข้องกับ Firebase ทํางานได้ และเนื่องจาก Gemini Developer API ได้รับอนุญาตผ่านคีย์ API เราขอแนะนําอย่างยิ่งว่าอย่าเพิ่ม Gemini Developer API (เรียกว่า "Generative Language API" ในคอนโซล Google Cloud) ลงในรายการที่อนุญาตของ API สําหรับคีย์ API ของ Firebase ซึ่งจะทำให้ Gemini Developer API มีความเสี่ยงที่จะเกิดการละเมิด
ฉันจะรักษาคีย์ Gemini API ให้ปลอดภัยได้อย่างไร
คำถามที่พบบ่อยนี้อธิบายแนวทางปฏิบัติแนะนำบางอย่างที่จะช่วยรักษาGeminiคีย์ API ให้ปลอดภัย
หากโทรหา Gemini Developer API โดยตรงจากแอปบนอุปกรณ์เคลื่อนที่หรือเว็บ
- ใช้ SDK ของไคลเอ็นต์ Firebase AI Logic
- อย่าเพิ่มคีย์ API Gemini ลงในโค้ดเบสของแอป
Firebase AI Logic มีบริการพร็อกซีที่รวมคีย์ Gemini API ของคุณไว้ในคำขอแต่ละรายการที่ส่งไปยัง Gemini Developer API โดยดำเนินการทั้งหมดในแบ็กเอนด์
นอกจากนี้ เราขอแนะนําอย่างยิ่งให้ทําดังนี้
ทันทีที่คุณเริ่มพัฒนาแอปอย่างจริงจัง ให้ผสานรวมกับ Firebase App Check เพื่อช่วยปกป้องทรัพยากรแบ็กเอนด์และ API ที่ใช้เข้าถึง Generative Algorithms
อย่านําคีย์ Gemini API ที่ Firebase สร้างขึ้นไปใช้ซ้ำนอก Firebase AI Logic หากต้องการGeminiคีย์ API สําหรับกรณีการใช้งานอื่น ให้สร้างคีย์แยกต่างหาก
โดยทั่วไปแล้ว คุณไม่ควรแก้ไขGeminiคีย์ API ที่ Firebase สร้างขึ้น คีย์นี้มีชื่อว่าคีย์ API ของนักพัฒนาแอป Gemini (สร้างขึ้นโดย Firebase โดยอัตโนมัติ) ในคอนโซล Google Cloud
อย่าเพิ่ม API อื่นๆ ลงในรายการที่อนุญาตของ API สำหรับคีย์ Gemini API ที่ Firebase สร้างขึ้น ในรายการที่อนุญาตของ API นั้น Gemini คีย์ API ควรมี เท่านั้น Gemini Developer API (เรียกว่า "Generative Language API" ในคอนโซล Google Cloud)
อย่าเพิ่มการจํากัดแอป มิเช่นนั้นบริการพร็อกซี Firebase AI Logic จะไม่ทํางานตามที่คาดไว้
คีย์ Gemini API ของฉันถูกแฮ็ก สิ่งที่ต้องทำ
หากคีย์ Gemini API ของคุณถูกบุกรุก ให้ทําตามวิธีการเพื่อเปลี่ยนคีย์ Gemini API ที่ใช้ในการเรียก Gemini Developer API
นอกจากนี้ โปรดอ่านแนวทางปฏิบัติแนะนำเพื่อรักษาGeminiคีย์ API ให้ปลอดภัย
แก้ไขข้อผิดพลาด
ฉันจะแก้ไขข้อผิดพลาด 404 นี้ได้อย่างไร Firebase AI Logic genai config not found
หากคุณพยายามใช้ Gemini Developer API และได้รับข้อผิดพลาด 404 ที่ระบุว่า Firebase AI Logic genai config not found
โดยทั่วไปแล้วหมายความว่าโปรเจ็กต์ Firebase ของคุณไม่มีคีย์ Gemini API ที่ถูกต้องสำหรับใช้กับ SDK ของไคลเอ็นต์ Firebase AI Logic
สาเหตุที่เป็นไปได้มากที่สุดของข้อผิดพลาดนี้ ได้แก่
คุณยังไม่ได้ตั้งค่าโปรเจ็กต์ Firebase สำหรับ Gemini Developer API
สิ่งที่ต้องทำ
ในคอนโซล Firebase ให้ไปที่หน้า Firebase AI Logic คลิกเริ่มต้นใช้งาน แล้วเลือก Gemini Developer API เปิดใช้ API แล้วคอนโซลจะสร้างโปรเจ็กต์สำหรับ Gemini Developer API หลังจากทำเวิร์กโฟลว์เสร็จแล้ว ให้ลองส่งคำขออีกครั้งหากคุณเพิ่งทำตามเวิร์กโฟลว์การตั้งค่า Firebase AI Logic ในคอนโซล Firebase คีย์ Gemini API อาจยังไม่พร้อมใช้งานสำหรับบริการแบ็กเอนด์ที่จำเป็นทั้งหมดในทุกภูมิภาค
สิ่งที่ต้องทำ
รอสักครู่แล้วลองส่งคำขออีกครั้งคีย์ API Gemini อาจถูกลบออกจากโปรเจ็กต์ Firebase แล้ว
สิ่งที่ต้องทํา
ดูวิธีเปลี่ยนคีย์ Gemini API ที่ Firebase AI Logic ใช้
ฉันจะแก้ไขข้อผิดพลาด 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 ในโปรเจ็กต์ นี่เป็นปัญหาที่ทราบอยู่แล้วเกี่ยวกับโปรเจ็กต์บางรายการ และเรากำลังดำเนินการแก้ไขทั่วโลก
วิธีแก้ปัญหาในการแก้ไขโปรเจ็กต์และจัดสรรตัวแทนบริการเหล่านี้อย่างถูกต้องเพื่อให้คุณเริ่มรวม URL Cloud Storage for Firebase ไว้ในคำขอแบบหลายรูปแบบได้ คุณต้องเป็นเจ้าของโปรเจ็กต์ และคุณต้องทำชุดงานนี้เพียงครั้งเดียวสำหรับโปรเจ็กต์
เข้าถึงและตรวจสอบสิทธิ์ด้วย gcloud CLI
วิธีที่ง่ายที่สุดในการทำเช่นนี้คือการส่งจาก Cloud Shell ดูข้อมูลเพิ่มเติมในเอกสารประกอบGoogle Cloudหากได้รับข้อความแจ้ง ให้ทําตามวิธีการที่แสดงในเทอร์มินัลเพื่อทําให้ gcloud CLI ทำงานกับโปรเจ็กต์ Firebase
คุณจะต้องมีรหัสโปรเจ็กต์ Firebase ซึ่งดูได้ที่ด้านบนของส่วนการตั้งค่าโปรเจ็กต์ในคอนโซล Firebasesettings
จัดสรร 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 ''
โปรดรอสักครู่เพื่อให้แน่ใจว่ามีการจัดสรรตัวแทนบริการแล้ว จากนั้นลองส่งคําขอแบบหลายสื่อที่มี URL Cloud Storage for Firebase อีกครั้ง
หากยังคงได้รับข้อผิดพลาดนี้หลังจากรอหลายนาทีแล้ว โปรดติดต่อทีมสนับสนุน Firebase
ฉันจะแก้ไขข้อผิดพลาด 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
ฉันจะแก้ไขข้อผิดพลาด 403 นี้ได้อย่างไร Requests to this API firebasevertexai.googleapis.com ... are blocked.
หากได้รับข้อผิดพลาด 403 ที่ระบุว่า Requests to this API firebasevertexai.googleapis.com ... are blocked.
โดยทั่วไปหมายความว่าคีย์ API ในไฟล์/ออบเจ็กต์การกําหนดค่า Firebase ไม่มี API ที่จําเป็นในรายการที่อนุญาตสําหรับผลิตภัณฑ์ที่คุณพยายามใช้
ตรวจสอบว่าคีย์ API ที่แอปของคุณใช้มีAPI ที่จำเป็นทั้งหมดรวมอยู่ในรายการที่อนุญาต "ข้อจำกัด API" ของคีย์ สำหรับ Firebase AI Logic คีย์ API ของคุณต้องมี Firebase AI Logic API อย่างน้อย 1 รายการในรายการที่อนุญาต
คุณดูคีย์ API ทั้งหมดได้ในแผงAPI และบริการ > ข้อมูลเข้าสู่ระบบ ในคอนโซล Google Cloud
ฉันจะแก้ไขข้อผิดพลาด 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
แสดงความคิดเห็นเกี่ยวกับประสบการณ์การใช้งาน Firebase AI Logic