Câu hỏi thường gặp và cách khắc phục sự cố

Tại sao tên lại thay đổi từ "Vertex AI in Firebase" thành "Firebase AI Logic"?

Vào năm 2024, chúng tôi đã ra mắt một bộ SDK máy khách Firebase có thể sử dụng Vertex AI Gemini API cũng như một cổng uỷ quyền Firebase để bảo vệ API đó khỏi hành vi sai trái và cho phép tích hợp với các sản phẩm khác của Firebase. Chúng tôi gọi sản phẩm của mình là "Vertex AI in Firebase" và tên sản phẩm này mô tả chính xác các trường hợp sử dụng hiện có của sản phẩm tại thời điểm đó.

Tuy nhiên, kể từ đó, chúng tôi đã mở rộng các chức năng của sản phẩm. Ví dụ: kể từ tháng 5 năm 2025, chúng tôi hiện hỗ trợ Gemini Developer API, bao gồm cả khả năng bảo vệ Gemini Developer API khỏi hành vi sai trái bằng cách tích hợp với Firebase App Check.

Do đó, tên "Vertex AI in Firebase" không còn thể hiện chính xác phạm vi mở rộng của sản phẩm này. Do đó, tên mới — Firebase AI Logic — phản ánh chính xác hơn tập tính chất đang phát triển của chúng tôi và cho phép chúng tôi tiếp tục mở rộng các sản phẩm/dịch vụ trong tương lai!

Hãy xem hướng dẫn di chuyển để đảm bảo bạn nhận được tất cả các tính năng mới nhất từ Firebase AI Logic (và có thể bắt đầu sử dụng Gemini Developer API).

Sự khác biệt giữa việc sử dụng Gemini Developer API và Vertex AI Gemini API là gì?

Bảng sau đây liệt kê những điểm khác biệt quan trọng giữa hai nhà cung cấp "Gemini API" nói chung, bất kể cách bạn truy cập vào họ:

¹ Hai nhà cung cấp API này có mức giá trả tiền theo mức dùng khác nhau (tìm hiểu thêm trong tài liệu tương ứng của họ).

² Files API cho Gemini Developer API không được hỗ trợ thông qua Firebase AI Logic SDK.

Bảng sau đây liệt kê khả năng sử dụng các tính năng thường được hỏi đối với 2 nhà cung cấp "Gemini API". Bảng này áp dụng cụ thể khi sử dụng Firebase AI Logic SDK ứng dụng.

Tôi có thể dùng cả Gemini Developer API và Vertex AI Gemini API không?

Có, bạn có thể bật cả hai nhà cung cấp "Gemini API" trong dự án Firebase và có thể sử dụng cả hai API trong chính ứng dụng của mình.

Để chuyển đổi giữa các nhà cung cấp API trong mã của bạn, chỉ cần đảm bảo rằng bạn đã thiết lập dịch vụ phụ trợ một cách thích hợp trong mã của mình.

Những API bắt buộc là gì? Làm cách nào để bật các tính năng này?

Để sử dụng Firebase AI Logic SDK với Gemini Developer API, dự án của bạn phải bật 2 API sau:

• Gemini Developer API (generativelanguage.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

Bạn nên bật 2 API này bằng bảng điều khiển Firebase:

1. Trong bảng điều khiển Firebase, hãy chuyển đến trang Firebase AI Logic.

2. Nhấp vào Bắt đầu.

3. Chọn để bắt đầu sử dụng Gemini Developer API.

   Thao tác này sẽ khởi chạy một quy trình có hướng dẫn để cho phép bạn sử dụng 2 API này. Bảng điều khiển cũng sẽ tạo khoá API Gemini, cũng như thêm API Firebase AI Logic vào danh sách cho phép đối với khoá API Firebase của bạn.

Làm cách nào để tắt API trong dự án Firebase?

Đối với Firebase AI Logic, chúng tôi cố gắng giúp bạn thiết lập dự án Firebase để sử dụng nhà cung cấp Gemini API mà bạn chọn một cách dễ dàng nhất có thể. Trong đó có việc bật các API bắt buộc trong dự án Firebase của bạn trong những hành trình cụ thể, chẳng hạn như quy trình có hướng dẫn trong bảng điều khiển Firebase.

Tuy nhiên, nếu quyết định không sử dụng Firebase AI Logic hoặc một trong các nhà cung cấp Gemini API, bạn có thể tắt các API liên kết trong dự án Firebase của mình.

Bạn có thể sử dụng những mô hình nào với các SDK Firebase AI Logic?

Xem danh sách các mô hình được hỗ trợ. Chúng tôi thường xuyên bổ sung các chức năng mới cho SDK, vì vậy, hãy thường xuyên kiểm tra phần Câu hỏi thường gặp này để biết thông tin cập nhật (cũng như trong ghi chú phát hành, blog và bài đăng trên mạng xã hội).

• Gemini Developer API

  • Cả Gemini và Imagen đều là mô hình cơ bản.

    Xin lưu ý rằng Gemini Developer API (bất kể cách truy cập) chỉ hỗ trợ các mô hình Imagen ổn định cụ thể.

• Vertex AI Gemini API

  • Cả Gemini và Imagen đều là mô hình cơ bản.

• Bất kể bạn chọn nhà cung cấp Gemini API nào

  • Firebase AI Logic không hỗ trợ những nội dung sau:

    • Mô hình không phải mô hình nền tảng Gemini (chẳng hạn như mô hình PaLM, mô hình được điều chỉnh hoặc mô hình dựa trên Gemma).

    • Các mô hình Imagen cũ hơn hoặc imagen-3.0-capability-001.

Việc cần làm khi các mô hình bị tắt (gỡ bỏ)?

Khi phát hành một phiên bản mô hình ổn định, chúng tôi cố gắng đảm bảo rằng phiên bản đó có sẵn ít nhất một năm trước khi ngừng cung cấp mô hình.

Nơi tìm ngày ngừng hoạt động của một mô hình

Sau đây là một số cách để tìm ngày ngừng hoạt động của một mẫu:

• Tại thời điểm phát hành: Chúng tôi liệt kê ngày ngừng hoạt động dự kiến của từng mô hình ở một số nơi trong tài liệu về nhà cung cấp Gemini API cũng như trong tài liệu về Firebase (xem trang mô hình được hỗ trợ).

• Khi gần đến ngày ngừng hoạt động: Google sẽ gửi email cho các thành viên dự án phù hợp và đăng lời nhắc trong ghi chú phát hành cũng như các kênh khác về mọi hoạt động ngừng hoạt động sắp tới (ví dụ: lời nhắc về ngày ngừng hoạt động đối với các mô hình ổn định 1.5 và 1.0 của Gemini).

Bạn nên làm gì nếu mô hình bạn đang sử dụng sắp ngừng hoạt động?

1. Tìm một kiểu máy hiện được hỗ trợ phù hợp và tên kiểu máy của kiểu máy đó.

2. Cập nhật tên mô hình mà ứng dụng của bạn sử dụng trước ngày ngừng hoạt động; nếu không, mọi yêu cầu đối với mô hình đó sẽ không thành công và trả về lỗi 404.

   • Bạn đặt tên mẫu trong quá trình khởi chạy khi tạo một thực thể GenerativeModel, LiveModel hoặc ImagenModel. Hãy nhớ xem xét đề xuất quan trọng bên dưới về việc sử dụng Firebase Remote Config.

   • Khi sử dụng Firebase AI Logic, bạn thường không cần sửa đổi bất kỳ mã nào thực sự gọi mô hình.

3. Kiểm thử ứng dụng để đảm bảo rằng các phản hồi vẫn như mong đợi.

Imagencác mô hình ổn định – ngày ngừng hoạt động và các mô hình thay thế

• Tất cả các mô hình Imagen sẽ ngừng hoạt động vào ngày 24 tháng 6 năm 2026.

Thay thế: Di chuyển các ứng dụng của bạn để sử dụng mô hình Gemini hình ảnh ("Nano Banana").

Gemini 2.0các mô hình ổn định – ngày ngừng hoạt động và các mô hình thay thế

• Gemini 2.0 Flash và Gemini 2.0 Flash‑Lite:

  gemini-2.0-flash-001 (và bí danh được cập nhật tự động là gemini-2.0-flash)
  gemini-2.0-flash-lite-001 (và bí danh được cập nhật tự động là gemini-2.0-flash-lite)

  • Ngày 6 tháng 2 năm 2026: Bạn sẽ không thể sử dụng các mô hình này trong những dự án chưa từng sử dụng mô hình trước đây.

  • Ngày 31 tháng 3 năm 2026: Các mẫu này sẽ ngừng hoạt động.

  Xin lưu ý rằng các mô hình Gemini Live API 2.0 ổn định sẽ không bị ảnh hưởng.

Thay thế: Di chuyển để sử dụng mô hình Gemini 2.5 (chẳng hạn như gemini-2.5-flash-lite) hoặc thử một trong các mô hình Gemini 3 mới (chẳng hạn như gemini-3.1-flash-lite-preview).

Các mô hình ổn định 1.5 và 1.0 của Gemini – ngày ngừng hoạt động và các mô hình thay thế

• Mẫu Gemini 1.5 Pro:

  • gemini-1.5-pro-002 (và gemini-1.5-pro): Ngày 24 tháng 9 năm 2025
  • gemini-1.5-pro-001: Ngày 24 tháng 5 năm 2025

• Mẫu Gemini 1.5 Flash:

  • gemini-1.5-flash-002 (và gemini-1.5-flash): Ngày 24 tháng 9 năm 2025
  • gemini-1.5-flash-001: Ngày 24 tháng 5 năm 2025

• Các mô hình Gemini 1.0 Pro Vision: Ngày 21 tháng 4 năm 2025 (trước đây dự kiến là ngày 9 tháng 4 năm 2025)

• Các mô hình Gemini 1.0 Pro: Ngày 21 tháng 4 năm 2025 (trước đây dự kiến là ngày 9 tháng 4 năm 2025)

Thay thế: Di chuyển để sử dụng mô hình Gemini 2.5 (chẳng hạn như gemini-2.5-flash-lite) hoặc thử một trong các mô hình Gemini 3 mới (chẳng hạn như gemini-3.1-flash-lite-preview).

Làm cách nào để đặt hạn mức theo người dùng?

Theo mặc định, Firebase AI Logic đặt hạn mức yêu cầu cho mỗi người dùng là 100 yêu cầu mỗi phút (RPM).

Nếu muốn điều chỉnh hạn mức cho mỗi người dùng, bạn cần điều chỉnh chế độ cài đặt hạn mức cho API Firebase AI Logic.

Tìm hiểu thêm về Firebase AI Logic hạn mức API. Trên trang đó, bạn cũng có thể tìm hiểu cách xem và chỉnh sửa hạn mức.

Những quyền nào có thể cần thiết để sử dụng các SDK Firebase AI Logic?

Firebase AI Logic có sử dụng dữ liệu của tôi để huấn luyện các mô hình không?

Xem phần Quản trị dữ liệu và AI có trách nhiệm.

Tôi có bắt buộc phải sử dụng loại MIME trong các yêu cầu đa phương thức không? (chẳng hạn như đối với hình ảnh, tệp PDF, video và đầu vào âm thanh)

Có, trong mỗi yêu cầu đa phương thức, bạn phải luôn cung cấp những thông tin sau:

• mimeType của tệp. Xem một trường hợp ngoại lệ bên dưới.

• Tệp. Bạn có thể cung cấp tệp dưới dạng dữ liệu nội tuyến hoặc cung cấp tệp bằng URL của tệp.

Tìm hiểu về các loại tệp đầu vào được hỗ trợ, cách chỉ định loại MIME và 2 lựa chọn để cung cấp tệp trong phần Các tệp đầu vào được hỗ trợ và yêu cầu.

Trường hợp ngoại lệ khi đưa loại MIME vào yêu cầu

Một trường hợp ngoại lệ khi cung cấp loại MIME là đầu vào hình ảnh cùng dòng cho các yêu cầu từ ứng dụng nền tảng Android và Apple gốc.

Các SDK Firebase AI Logic cho nền tảng Android và Apple cung cấp một cách thức đơn giản và thân thiện với nền tảng để xử lý hình ảnh trong các yêu cầu – tất cả hình ảnh (bất kể định dạng) đều được chuyển đổi phía máy khách sang JPEG với chất lượng 80% trước khi được gửi đến máy chủ. Điều này có nghĩa là khi cung cấp hình ảnh dưới dạng dữ liệu nội tuyến bằng cách sử dụng SDK của nền tảng Android và Apple, bạn không cần chỉ định loại MIME trong yêu cầu.

Cách xử lý đơn giản này được trình bày trong tài liệu Firebase AI Logic trong các ví dụ về việc gửi hình ảnh được mã hoá base64 trong các yêu cầu.

Sau đây là một số thông tin bổ sung về tính năng này theo từng nền tảng:

• Đối với Android:

  • Bạn có thể tận dụng cách đơn giản hoá để xử lý các loại hình ảnh gốc của nền tảng (Bitmap) trong các câu lệnh đa phương thức có chứa hình ảnh dưới dạng dữ liệu nội tuyến (xem ví dụ).

  • Để kiểm soát tốt hơn các định dạng và lượt chuyển đổi hình ảnh, bạn có thể cung cấp hình ảnh dưới dạng InlineDataPart và cung cấp loại MIME cụ thể. Ví dụ:

    content { inlineData(/* PNG as byte array */, "image/png") }

• Đối với các nền tảng của Apple:

  • Bạn có thể tận dụng cách đơn giản hoá để xử lý các loại hình ảnh gốc của nền tảng (UIImage, NSImage, CIImage và CGImage) trong các câu lệnh đa phương thức có chứa hình ảnh dưới dạng dữ liệu nội tuyến (xem ví dụ).

  • Để kiểm soát tốt hơn các định dạng và lượt chuyển đổi hình ảnh, bạn có thể cung cấp hình ảnh dưới dạng InlineDataPart và cung cấp loại MIME cụ thể. Ví dụ:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

Các tính năng này có dùng được khi sử dụng Firebase AI Logic không? Lưu vào bộ nhớ đệm theo bối cảnh, tinh chỉnh mô hình, tạo các mục nhúng và truy xuất ngữ nghĩa?

Các tính năng sau được nhiều mô hình và nhà cung cấp API hỗ trợ, nhưng không có sẵn khi sử dụng Firebase AI Logic:

• Lưu ngữ cảnh vào bộ nhớ đệm
• Tinh chỉnh mô hình
• Tạo mục nhúng
• Truy xuất ngữ nghĩa

Nếu bạn muốn thêm những yêu cầu này dưới dạng yêu cầu về tính năng hoặc bình chọn cho một yêu cầu về tính năng hiện có, hãy truy cập vào Firebase UserVoice.

Đối với các ứng dụng Swift trên nền tảng Apple – Tôi nên làm gì khi tên mô-đun thay đổi từ FirebaseAI thành FirebaseAILogic?

Đối với các ứng dụng trên nền tảng Apple, bắt đầu từ Firebase SDK phiên bản 12.5.0, Firebase AI Logic hiện được phân phối trong mô-đun FirebaseAILogic. Chúng tôi đã thực hiện thay đổi này mà không làm gián đoạn và vẫn tương thích ngược.

Tại sao chúng tôi thực hiện thay đổi này?

Trước đây, chúng tôi phân phối dịch vụ này trong mô-đun FirebaseAI. Tuy nhiên, chúng tôi cần đổi tên thành FirebaseAILogic vì những lý do sau:

• Tránh xung đột tên giữa mô-đun và lớp gây ra vấn đề trong các bản phân phối nhị phân.

• Cho phép chúng tôi sử dụng macro Swift để phát triển các tính năng trong tương lai.

Điều cần làm nếu bạn đang nâng cấp lên phiên bản 12.5.0 trở lên?

Việc thay đổi tên mô-đun thành FirebaseAILogic không làm gián đoạn và tương thích ngược. Tuy nhiên, cuối cùng, chúng tôi có thể xoá mô-đun cũ cùng với một bản phát hành thay đổi có thể gây lỗi lớn trong SDK Firebase trong tương lai (khung thời gian hiện chưa xác định).

Không có thay đổi bắt buộc nào đối với việc thay đổi tên mô-đun này, nhưng bạn nên làm những việc sau:

1. Khi chọn các phần phụ thuộc Swift PM, hãy chọn FirebaseAILogic (thay vì FirebaseAI).

2. Thay đổi câu lệnh nhập thành FirebaseAILogic (thay vì FirebaseAI).

Khoá API Gemini là gì?

Gemini Developer API sử dụng "khoá API Gemini" để uỷ quyền cho phương thức gọi. Vì vậy, nếu đang sử dụng Gemini Developer API thông qua Firebase AI Logic SDK, thì bạn cần có một khoá API Gemini hợp lệ trong dự án Firebase để gọi API đó.

"Khoá API Gemini" chỉ có nghĩa là khoá API có Gemini Developer API trong danh sách cho phép API.

Khi bạn thực hiện quy trình thiết lập Firebase AI Logic trong bảng điều khiển Firebase, chúng tôi sẽ tạo một khoá API Gemini chỉ giới hạn ở Gemini Developer API và thiết lập dịch vụ proxy Firebase AI Logic để sử dụng khoá API này. Khoá API Gemini do Firebase tạo có tên là Khoá Gemini Developer API (do Firebase tự động tạo) trong trang thông tin đăng nhập của bảng điều khiển Google Cloud.

Tìm hiểu thêm về các quy tắc hạn chế API đối với khoá API.

Bạn không thêm khoá API Gemini vào cơ sở mã của ứng dụng khi sử dụng SDK Firebase AI Logic. Tìm hiểu thêm về cách bảo mật khoá API Gemini.

Tôi có nên thêm khoá API Gemini vào cơ sở mã của ứng dụng di động hoặc ứng dụng web không?

Khi sử dụng SDK Firebase AI Logic, không thêm khoá API Gemini vào cơ sở mã của ứng dụng.

Trên thực tế, trong khi phát triển bằng các SDK Firebase AI Logic, bạn không tương tác trực tiếp với khoá API Gemini. Thay vào đó, dịch vụ proxy Firebase AI Logic của chúng tôi sẽ tự động thêm khoá API Gemini vào mỗi yêu cầu gửi đến Gemini Developer API – hoàn toàn ở phần phụ trợ.

Làm cách nào để thay đổi khoá API Gemini dùng để gọi Gemini Developer API?

Khi sử dụng SDK Firebase AI Logic, bạn có thể sẽ không cần thay đổi khoá API Gemini. Tuy nhiên, sau đây là 2 trường hợp bạn có thể cần phải:

• Nếu bạn vô tình làm lộ khoá và muốn thay thế bằng một khoá bảo mật mới.

• Nếu bạn vô tình xoá khoá. Xin lưu ý rằng bạn có thể huỷ xoá khoá trong vòng 30 ngày kể từ ngày xoá.

Sau đây là cách thay đổi khoá API Gemini mà các SDK Firebase AI Logic sử dụng:

1. Nếu khoá API Gemini do Firebase tạo vẫn còn, hãy xoá khoá đó.

   Bạn có thể xoá khoá API này trong bảng điều khiển API và Dịch vụ > Thông tin xác thực của bảng điều khiển Google Cloud. Khoá này có tên là:
   Khoá Gemini Developer API (do Firebase tự động tạo).

2. Trong cùng trang đó của bảng điều khiển Google Cloud, hãy tạo một khoá API mới. Bạn nên đặt tên cho khoá này theo cách như sau:
   Khoá Gemini Developer API cho Firebase.

3. Đối với khoá API mới này, hãy thêm các quy tắc hạn chế đối với API và chỉ chọn Generative Language API.
   "Generative Language API" là tên gọi đôi khi được dùng cho Gemini Developer API trong bảng điều khiển Google Cloud.

   Không thêm bất kỳ hạn chế nào đối với ứng dụng; nếu không, dịch vụ proxy Firebase AI Logic sẽ không hoạt động như mong đợi.

4. Chạy lệnh sau để đặt khoá mới này làm khoá API Gemini mà dịch vụ proxy Firebase AI Logic sẽ sử dụng.

   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}\"}}"
   

   Tìm hiểu về gcloud CLI.

Hãy nhớ không thêm khoá API Gemini mới này vào cơ sở mã của ứng dụng. Tìm hiểu thêm về cách bảo mật khoá API Gemini.

Tôi có thể dùng "khoá API Firebase" làm khoá API Gemini không?

Không – bạn không nên sử dụng "khoá API Firebase" làm khoá API Gemini. Bạn không nên thêm Gemini Developer API vào danh sách cho phép đối với khoá API Firebase.

Khoá API Firebase là khoá API có trong tệp cấu hình Firebase hoặc đối tượng mà bạn thêm vào cơ sở mã của ứng dụng để kết nối ứng dụng với Firebase. Bạn có thể đưa khoá API Firebase vào mã của mình khi chỉ sử dụng khoá này với các API liên quan đến Firebase (chẳng hạn như Firebase AI Logic). Tìm hiểu thông tin quan trọng về khoá API Firebase.

Trong bảng điều khiển API và Dịch vụ > Thông tin xác thực của bảng điều khiển Google Cloud, khoá API của Firebase sẽ có dạng như sau:

Vì bạn cần thêm khoá API Firebase vào cơ sở mã của ứng dụng để các API liên quan đến Firebase hoạt động, và vì Gemini Developer API được uỷ quyền thông qua khoá API, bạn TUYỆT ĐỐI KHÔNG nên thêm Gemini Developer API (được gọi là "Generative Language API" trong bảng điều khiển Google Cloud) vào danh sách cho phép API cho khoá API Firebase. Nếu làm vậy, bạn sẽ để lộ Gemini Developer API cho hành vi sai trái tiềm ẩn.

Làm cách nào để bảo mật khoá API Gemini?

Câu hỏi thường gặp này mô tả một số phương pháp hay nhất nên áp dụng để bảo mật khoá API Gemini của bạn.

Nếu bạn đang gọi Gemini Developer API trực tiếp từ ứng dụng di động hoặc ứng dụng web:

• Sử dụng các SDK ứng dụng Firebase AI Logic.
• Không thêm khoá API Gemini vào cơ sở mã của ứng dụng.

Firebase AI Logic cung cấp một dịch vụ proxy bao gồm khoá API Gemini của bạn trong mỗi yêu cầu đến Gemini Developer API – hoàn toàn ở phần phụ trợ.

Ngoài ra, bạn nên làm những việc sau:

• Ngay khi bắt đầu phát triển ứng dụng một cách nghiêm túc, hãy tích hợp với Firebase App Check để giúp bảo vệ các tài nguyên phụ trợ cũng như các API được dùng để truy cập vào các mô hình tạo sinh.

• Không sử dụng lại khoá API Gemini do Firebase tạo bên ngoài Firebase AI Logic. Nếu bạn cần khoá API Gemini cho một trường hợp sử dụng khác, hãy tạo một khoá riêng.

• Nhìn chung, bạn KHÔNG NÊN sửa đổi khoá API Gemini do Firebase tạo. Khoá này có tên là Khoá Gemini Developer API (do Firebase tự động tạo) trong bảng điều khiển Google Cloud.

  • Không thêm bất kỳ API nào khác vào danh sách cho phép API cho khoá API Gemini do Firebase tạo. Trong danh sách cho phép sử dụng API, khoá API Gemini của bạn chỉ nên có Gemini Developer API (được gọi là "Generative Language API" trong bảng điều khiển Google Cloud).

  • Không thêm bất kỳ hạn chế nào đối với ứng dụng; nếu không, dịch vụ proxy Firebase AI Logic sẽ không hoạt động như mong đợi.

Khoá API Gemini của tôi đã bị xâm nhập. Việc bạn cần làm

Nếu khoá API Gemini của bạn bị xâm phạm, hãy làm theo hướng dẫn để thay đổi khoá API Gemini được dùng để gọi Gemini Developer API.

Ngoài ra, hãy tham khảo các phương pháp hay nhất được đề xuất để bảo mật khoá API Gemini của bạn.