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

Sự khác biệt giữa việc sử dụng Gemini Developer API và Agent Platform Gemini API (formerly Vertex AI)

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 các nhà cung cấp này:

¹ Hai nhà cung cấp API 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 SDK Firebase AI Logic.

Bảng sau đây liệt kê khả năng sử dụng các tính năng thường được hỏi về hai 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.

Cách sử dụng cả Gemini Developer API và Agent Platform Gemini API (formerly Vertex AI)

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ã, 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.

Các API bắt buộc và cách bật

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

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

Bạn nên bật hai 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 phần Dịch vụ AI > Logic AI.

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 làm việc có hướng dẫn để bật hai API cho bạn. Firebase cũng sẽ cung cấp một tài khoản dịch vụ do Google quản lý (P4SA) để cho phép sử dụng Gemini API, 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.

Cách 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ể. Việc này bao gồm cả việc bật các API bắt buộc trong dự án Firebase của bạn trong một số hành trình cụ thể, chẳng hạn như quy trình công việc 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.

Các quyền cần có để sử dụng Firebase AI Logic

Các mẫu được hỗ trợ khi sử dụng Firebase AI Logic

Xem danh sách các mẫu được hỗ trợ. Chúng tôi thường xuyên bổ sung các tính năng mới cho SDK, vì vậy, hãy xem lại 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).

• Firebase AI Logic hỗ trợ các mô hình sau:

  • Gemini Developer API

    • Hầu hết các mô hình nền tảng Gemini

  • Agent Platform Gemini API (formerly Vertex AI)

    • Hầu hết các mô hình nền tảng Gemini

• Firebase AI Logic không hỗ trợ các mẫu sau (bất kể nhà cung cấp Gemini API mà bạn chọn):

  • Mô hình tinh chỉnh

  • Mô hình nhúng, mô hình Veo, mô hình Lyria, mô hình robot, mô hình sử dụng máy tính, mô hình Gemini Omni hoặc mô hình Gemini Cyber

Cách đặt giới hạn tần suất cho mỗi 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 giới hạn số lượng yêu cầu 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 của mình.

Cách giảm độ trễ và mức sử dụng mã thông báo cao

Nếu bạn gặp phải độ trễ cao hoặc mức sử dụng mã thông báo cao, thì có thể là do cấu hìnhmức độ suy nghĩ cho mô hình bạn đang sử dụng.

Gemini 3 và các mô hình mới hơn luôn sử dụng "quy trình tư duy" nội bộ giúp cải thiện đáng kể khả năng suy luận và lập kế hoạch nhiều bước, giúp các mô hình này hoạt động hiệu quả trong những nhiệm vụ phức tạp như lập trình, toán học nâng cao và phân tích dữ liệu.

Tuy nhiên, tuỳ thuộc vào nhiệm vụ, không phải lúc nào bạn cũng cần đến cấp độ tư duy cao hơn, và bạn có thể định cấu hình mô hình để sử dụng cấp độ tư duy thấp hơn. Mức độ suy nghĩ thấp hơn sẽ giúp giảm độ trễ và mức sử dụng mã thông báo. Để giúp bạn quyết định mức độ cần thiết của khả năng tư duy đối với một mô hình, hãy xem phần so sánh độ khó của nhiệm vụ.

Xin lưu ý rằng đối với hầu hết các mô hình Gemini 3 trở lên, cấp độ tư duy mặc định được đặt thành HIGH.

Yêu cầu về loại MIME đối với các yêu cầu đa phương thức (chẳng hạn như đối với hình ảnh, tệp PDF, video và dữ liệu âm thanh đầu vào)

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

• Tệp mimeType. Hãy 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 cùng dòng 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à hai lựa chọn để cung cấp tệp trong phần Các loại 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

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

Firebase AI Logic SDK cho nền tảng Android và Apple cung cấp một cách đơ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 ở chất lượng 80% trước khi được gửi đến máy chủ. Điều này có nghĩa là khi bạn cung cấp hình ảnh dưới dạng dữ liệu cùng dòng bằng SDK 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 về Firebase AI Logic trong các ví dụ về cách gửi hình ảnh được mã hoá base64 trong 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âu lệnh đa phương thức chứa hình ảnh dưới dạng dữ liệu cùng dòng (xem ví dụ).

  • Để kiểm soát tốt hơn các định dạng hình ảnh và lượt chuyển đổi, 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 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 chứa hình ảnh dưới dạng dữ liệu cùng dòng (xem ví dụ).

  • Để kiểm soát tốt hơn các định dạng hình ảnh và lượt chuyển đổi, 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âng cao chưa dùng được khi sử dụng Firebase AI Logic: Căn cứ vào dữ liệu trên Google Tìm kiếm hình ảnh, tinh chỉnh mô hình, tạo mục nhúng và truy xuất ngữ nghĩa

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

• Neo bám với Google Hình ảnh
• 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 các tính năng 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.

Sử dụng dữ liệu để huấn luyện mô hình

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

Các mô hình không còn được dùng nữa hoặc đã ngừng hoạt động (ngừng hoạt động) – danh sách và các mô hình thay thế

Khi phát hành một phiên bản mô hình ổn định, chúng tôi cố gắng duy trì phiên bản đó trong ít nhất 12 tháng trước khi ngừng cung cấp (ngừng hoạt động) mô hình đó.

Tuy nhiên, hãy lưu ý những điều sau:

• Đối với Agent Platform Gemini API (formerly Vertex AI), một số mô hình ổn định chỉ có thời gian hoạt động ngắn hạn, tức là các mô hình đó có thể bị ngừng hoạt động (ngừng cung cấp) sớm nhất là 45 ngày sau khi mô hình thay thế được phát hành.

• Đối với Gemini Developer API, đôi khi thay vì tắt một mô hình, dịch vụ sẽ tự động định tuyến yêu cầu đến một mô hình mới hơn. Các yêu cầu gửi đến mô hình mới hơn sẽ được tính phí theo mức giá của mô hình mới hơn.

• Vài tuần trước ngày ngừng hoạt động, những dự án chưa từng sử dụng một mô hình sẽ bị chặn sử dụng mô hình đó.

• Khi một phiên bản ổn định được phát hành cho một mô hình nhất định, tất cả phiên bản thử nghiệm và phiên bản xem trước của mô hình đó thường sẽ bị ngừng hoạt động (ngừng cung cấp) trong vòng vài ngày hoặc vài tuần (phần Câu hỏi thường gặp này không liệt kê mọi mô hình xem trước và mô hình thử nghiệm trước đó).

Mô hình sử dụng chung

^{1 Đối với Agent Platform Gemini API (formerly Vertex AI), đây là "mô hình có sẵn trong thời gian ngắn". Xem Mẫu đặt tên và tạo phiên bản mô hình}

^{Tất cả các mô hình đa năng sau đây cũng sẽ ngừng hoạt động: gemini-1.0-pro, gemini-1.0-pro-001, gemini-1.0-pro-002, gemini-1.0-pro-vision, gemini-1.0-pro-vision-001 gemini-1.5-flash-001, gemini-1.5-flash, gemini-1.5-flash-002, gemini-1.5-pro-001, gemini-1.5-pro, gemini-1.5-pro-002}

Mô hình tạo hình ảnh (Nano Banana và Imagen)

Âm thanh – Live API mô hình

Những thay đổi cần thực hiện khi các mô hình không còn được dùng nữa hoặc bị ngừng hoạt động (ngừng cung cấp)

Tìm ngày ngừng hoạt động của một mô hình ở đâu?

Dưới đây là một số cách để bạn tìm ngày ngừng hoạt động của một mô hình:

• Google sẽ gửi email cho các thành viên phù hợp của dự án.

• Chúng tôi đăng thông báo và lời nhắc về các lần ngừng hoạt động sắp tới trên nhiều kênh:

  • Ghi chú phát hành (xem ví dụ)
  • Biểu ngữ cấp trang trong tài liệu, trang mô hình được hỗ trợ và Câu hỏi thường gặp về các mô hình không dùng nữa và đã ngừng hoạt động

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?

Bạn cần thực hiện những thay đổi này trước ngày ngừng hoạt động; nếu không, mọi yêu cầu đến một mô hình đã ngừng hoạt động sẽ không thành công và trả về lỗi 404.

1. Tìm một mô hình hiện được hỗ trợ phù hợp và tên mô hình của mô hình đó.

   Chúng tôi cũng cung cấp các mô hình thay thế được đề xuất trong phần Câu hỏi thường gặp về các mô hình không dùng nữa và đã ngừng hoạt động.

2. Cập nhật tên mô hình mà ứng dụng của bạn sử dụng.

   Bạn đặt tên mô hình 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 đề xuất quan trọng bên dưới về việc sử dụng Firebase Remote Config hoặc mẫu câu lệnh của máy chủ.

3. Kiểm tra xem bạn có cần cập nhật mã nào không.

   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. Sau đây là một số trường hợp ngoại lệ:

   • Các tham số lấy mẫu không được hỗ trợ: Các mô hình Gemini 4.x và Gemini 3.x mới nhất không hỗ trợ một số tham số (cụ thể là nhiệt độ, top-K, top-P, hình phạt tần suất, hình phạt hiện diện và số lượng đề xuất).

   • Cấp độ tư duy so với Ngân sách tư duy: Kể từ các mô hình Gemini 3.x, bạn nên sử dụng thinkingLevel thay vì thinkingBudget (nhưng thinkingBudget vẫn được hỗ trợ để đảm bảo khả năng tương thích ngược). Tuy nhiên, kể từ các mẫu Gemini 4.x, thinkingBudget không được hỗ trợ. Tìm hiểu thêm về tư duy.

   • Thử nghiệm với giá trị cấp độ tư duy: Khi nâng cấp lên một thế hệ mới (ví dụ: từ 2.5 lên 3.8) và muốn đảm bảo hiệu suất cũng như hành vi tương tự (ví dụ: độ trễ), bạn nên thử nghiệm đặt cấp độ tư duy thành một giá trị thấp hơn. Tìm hiểu thêm về tư duy.

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

Những thay đổi cần thiết để đổi mới thương hiệu "Vertex AI" thành "Nền tảng tác nhân"

Vào giữa năm 2026, Google Cloud đã đổi tên "Vertex AI" thành "Nền tảng tác nhân Gemini Enterprise" (hoặc "Nền tảng tác nhân"). Trong hệ sinh thái Firebase, chúng tôi gọi dịch vụ này là "Gemini API của Nền tảng tác nhân".

Đối với Google Cloud, việc đổi mới thương hiệu này bao gồm những thay đổi sau. Xin lưu ý rằng có những thay đổi khác, nhưng không áp dụng cho Firebase AI Logic.

• Đổi mới thương hiệu sản phẩm từ "Vertex AI" thành "Nền tảng tác nhân Gemini Enterprise" (hoặc "Nền tảng tác nhân"), bao gồm cả URL mới cho bảng điều khiển Google Cloud và tài liệu.

• Thay đổi tên hiển thị của API từ "Vertex AI API" thành "Agent Platform API". Xin lưu ý rằng tên dịch vụ vẫn giữ nguyên: aiplatform.googleapis.com.

• Đổi tên "Vertex AI Studio" thành "Agent Studio".

• Không có thay đổi nào đối với chức năng của các API cơ bản hoặc mô hình được hỗ trợ.

Đối với SDK Firebase AI Logic, chúng tôi đã điều chỉnh việc đổi mới thương hiệu này bằng cách cập nhật cú pháp khởi chạy cho dịch vụ phụ trợ "Gemini API" và cập nhật vị trí mặc định để truy cập vào mô hình khi sử dụng cú pháp mới này.

• Cú pháp khởi chạy mới cho dịch vụ phụ trợ "Gemini API":

  Swift

  Thay đổi vertexAI thành agentPlatform.

  • Cú pháp agentPlatform có sẵn từ phiên bản 12.17.0 trở lên của SDK.
  • Cú pháp vertexAI đã bị xoá trong phiên bản 13.0.0 của SDK.

  TRƯỚC

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))
  
  // ...
  

  SAU

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))
  
  // ...
  

  Kotlin

  Thay đổi vertexAI thành agentPlatform.

  • Cú pháp agentPlatform có trong SDK phiên bản 17.15.0 trở lên và Firebase Android BoM phiên bản 34.17.0 trở lên.
  • Cú pháp vertexAI đã bị xoá trong phiên bản 18.0.0 của SDK và phiên bản 35.0.0 của BoM.

  TRƯỚC

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
  
  // ...
  

  SAU

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))
  
  // ...
  

  Java

  Thay đổi vertexAI thành agentPlatform.

  • Cú pháp agentPlatform có trong SDK phiên bản 17.15.0 trở lên và Firebase Android BoM phiên bản 34.17.0 trở lên.
  • Cú pháp vertexAI đã bị xoá trong phiên bản 18.0.0 của SDK và phiên bản 35.0.0 của BoM.

  TRƯỚC

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));
  
  // ...
  

  SAU

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));
  
  // ...
  

  Web

  Thay đổi VertexAIBackend thành AgentPlatformBackend.

  • Cú pháp AgentPlatformBackend có sẵn từ phiên bản 12.17.0 trở lên của Firebase JS SDK.
  • Cú pháp VertexAIBackend đã bị xoá trong phiên bản 13.0.0 của SDK.

  TRƯỚC

  import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });
  
  // ...
  

  SAU

  import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `AgentPlatformBackend` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });
  
  // ...
  

  Dart

  Thay đổi vertexAI thành agentPlatform.

  • Cú pháp agentPlatform có từ phiên bản 3.15.0 trở lên của trình bổ trợ và phiên bản 4.18.0 trở lên của BoM Flutter Firebase.
  • Cú pháp vertexAI đã bị xoá trong phiên bản 5.0.0 của trình bổ trợ và phiên bản 5.0.0 trở lên của Firebase Flutter BoM.

  TRƯỚC

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  final ai = await FirebaseAI.vertexAI(location: 'LOCATION');
  
  // ...
  

  SAU

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');
  
  // ...
  

  Unity

  Thay đổi VertexAI thành AgentPlatform.

  • Cú pháp AgentPlatform có sẵn kể từ Firebase SDK cho Unity phiên bản 13.15.0 trở lên.
  • Cú pháp VertexAI đã bị xoá trong phiên bản 14.0.0 của SDK.

  TRƯỚC

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAI` syntax, the default location is `us-central1`, so
  // specifying a location is usually required since most models are *not* supported in `us-central1`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));
  
  // ...
  

  SAU

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
  // For the `AgentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));
  
  // ...
  

• Vị trí mặc định mới để truy cập vào mô hình khi sử dụng cú pháp khởi chạy mới:

  Khi sử dụng cú pháp khởi chạy "Nền tảng tác nhân" mới, vị trí mặc định là global.

  Thay đổi này được thực hiện vì hầu hết tất cả các mô hình Gemini đều được hỗ trợ trong global và Google Cloud không còn hỗ trợ vị trí us-central1 cho các bản phát hành mới của hầu hết các mô hình Gemini.

Đối với ứng dụng Swift – Những thay đổi cần thiết để di chuyển từ FirebaseAI sang FirebaseAILogic

Đối với các ứng dụng trên nền tảng của Apple, kể từ Firebase SDK phiên bản 12.5.0, Firebase AI Logic được phân phối trong mô-đun FirebaseAILogic. Trong SDK phiên bản 13.0.0, mô-đun FirebaseAI đã bị xoá.

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 kênh 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 tính năng trong tương lai.

Bạn nên làm gì nếu đang nâng cấp lên phiên bản 12.5.0 trở lên hoặc 13.0.0 trở lên?

Trong Firebase 12 (bắt đầu từ phiên bản 12.5.0 trở lên), việc thay đổi tên mô-đun thành FirebaseAILogic không gây lỗi và có khả năng tương thích ngược, vì vậy, bạn nên thực hiện những thay đổi này trong Firebase 12. Tuy nhiên, trong Firebase SDK phiên bản 13.0.0, mô-đun FirebaseAI cũ đã bị xoá, vì vậy, bạn bắt buộc phải thực hiện những thay đổi này khi nâng cấp lên Firebase 13.

1. Khi chọn 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).

Tìm hiểu về việc đổi tên 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 ứng dụng Firebase có thể sử dụng Agent Platform Gemini API (formerly Vertex AI) cũng như cổng proxy 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 đặt tên cho sản phẩm 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. Do đó, tên mới — Firebase AI Logic — phản ánh rõ hơn tập tính năng ngày càng 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 dịch vụ của mình trong tương lai!

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

Bắt buộc phải thực thi App Check đối với tất cả phiên bản của một ứng dụng

Bạn cần thực thi App Check cho tất cả phiên bản ứng dụng sử dụng Firebase AI Logic.

Điều quan trọng là bạn phải thực thi App Check càng sớm càng tốt, đặc biệt là trước khi bạn đưa ứng dụng vào hệ thống kiểm soát mã nguồn công khai, chia sẻ ứng dụng hoặc cung cấp ứng dụng công khai.

Nếu bạn triển khai App Check trong toàn bộ mã nguồn của ứng dụng ngay lập tức, thì tất cả các phiên bản ứng dụng của bạn đều có thể gửi mã thông báo App Check hợp lệ. Yêu cầu không gửi mã thông báo hợp lệ sẽ được coi là chưa được xác minh và sẽ bị chặn khi App Check được thực thi.

Nếu bạn đã phát hành một phiên bản ứng dụng cho người dùng cuối mà chưa triển khai App Check, hãy xem phần Câu hỏi thường gặp về cách triển khai và thực thi App Check cho một ứng dụng đã phát hành.

Trì hoãn việc tự động thực thi App Check cho Firebase AI Logic

Kể từ ngày 2 tháng 11 năm 2026, Firebase sẽ tự động thực thi Firebase App Check cho Firebase AI Logic trong dự án Firebase của bạn (nếu chưa được thực thi).

Khi App Check được thực thi, mọi yêu cầu đến Firebase AI Logic mà không có mã thông báo App Check hợp lệ sẽ bị chặn. Điều này bao gồm cả các phiên bản ứng dụng đã phát hành chưa triển khai nhà cung cấp dịch vụ chứng thực chính thức.

Nếu đã phát hành các phiên bản ứng dụng chưa triển khai App Check, thì bạn có thể tạm thời trì hoãn việc tự động thực thi App Check trong Firebase AI Logic. Tuy nhiên, trước ngày 21 tháng 1 năm 2027, bạn cần phải nỗ lực triển khai và thực thi App Check cho các ứng dụng đã phát hành.

Sau đây là cách trì hoãn việc tự động thực thi App Check cho Firebase AI Logic:

1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > Kiểm tra ứng dụng > API.

2. Tìm hàng cho Firebase AI Logic.

3. Ở cuối hàng, hãy tìm bộ chọn ngày Thực thi: có biểu tượng editChỉnh sửa.

4. Chọn ngày mà bạn muốn tự động thực thi App Check cho Firebase AI Logic.

   Ngày muộn nhất có thể là ngày 21 tháng 1 năm 2027. Sau ngày đó, bạn không thể trì hoãn việc tự động thực thi App Check cho Firebase AI Logic.

5. Nhấp vào Lưu.

Cách triển khai và thực thi App Check cho một ứng dụng đã phát hành

Đối với các phiên bản ứng dụng chưa triển khai App Check, các yêu cầu gửi đến Firebase AI Logic từ những phiên bản đó sẽ không có mã thông báo App Check hợp lệ và được coi là chưa xác minh. Các yêu cầu này sẽ bị chặn khi App Check được thực thi cho Firebase AI Logic.

Hướng dẫn sau đây giúp bạn di chuyển ứng dụng để có thể thực thi App Check theo cách tránh làm gián đoạn dịch vụ cho một ứng dụng đã phát hành không có App Check.

1. Trì hoãn việc tự động thực thi App Check cho Firebase AI Logic:

   1. Trong bảng điều khiển Firebase, hãy chuyển đến thẻ Bảo mật > Kiểm tra ứng dụng > API.

   2. Tìm hàng cho Firebase AI Logic.

   3. Ở cuối hàng, hãy tìm bộ chọn ngày Thực thi: có biểu tượng editChỉnh sửa.

   4. Chọn ngày mà bạn muốn tự động thực thi App Check cho Firebase AI Logic.

      Ngày muộn nhất có thể là ngày 21 tháng 1 năm 2027. Sau ngày đó, bạn không thể trì hoãn việc tự động thực thi App Check cho Firebase AI Logic.

   5. Nhấp vào Lưu.

2. Hãy triển khai nhà cung cấp dịch vụ chứng thực chính thức trong ứng dụng của bạn càng sớm càng tốt.

   • Nền tảng của Apple: DeviceCheck hoặc App Attest hoặc reCAPTCHA Enterprise
   • Android: Play Integrity hoặc reCAPTCHA Enterprise
   • Web: reCAPTCHA Enterprise
   • Flutter: Hỗ trợ tất cả các nhà cung cấp ở trên, bao gồm cả reCAPTCHA Enterprise
   • Unity: Hỗ trợ tất cả các nhà cung cấp ở trên (sắp hỗ trợ reCAPTCHA Enterprise)

3. Theo dõi các yêu cầu từ ứng dụng của bạn để giúp bạn quyết định thời điểm an toàn để thực thi App Check.

   Ví dụ: nếu hầu hết các yêu cầu gần đây đều đến từ ứng dụng khách đã xác minh, thì bạn nên cân nhắc việc thực thi App Check.

4. Thực thi App Check cho Firebase AI Logic.

5. Để phát triển cục bộ khi App Check được thực thi, bạn có thể thiết lập nhà cung cấp dịch vụ gỡ lỗi App Check mà vẫn thực thi App Check cho Firebase AI Logic.

Tìm hiểu về các bản nâng cấp bảo mật (giữa năm 2026) cho Gemini Developer API và Firebase AI Logic

Trước đây, Gemini Developer API dựa vào các khoá API Gemini tiêu chuẩn để cho phép sử dụng Gemini Developer API (generativelanguage.googleapis.com). Nếu bạn bật Firebase AI Logic và chọn sử dụng Gemini Developer API, thì Firebase sẽ tạo một khoá API Gemini cho bạn, khoá này chỉ được dùng cho Gemini Developer API. Chìa khoá này có tên là Gemini Developer API key (auto created by Firebase).

Kể từ giữa năm 2026, Gemini Developer API sẽ nâng cấp lên một giải pháp thay thế an toàn hơn có tên là "Khoá uỷ quyền (khoá xác thực)" (về cơ bản là tài khoản dịch vụ). Firebase AI Logic cũng được nâng cấp đồng thời. Thay vì sử dụng khoá API Gemini tiêu chuẩn, Firebase AI Logic hiện xử lý việc uỷ quyền cho Gemini Developer API bằng cách sử dụng tài khoản dịch vụ do Google quản lý (P4SA) mà chúng tôi tự động cấp cho bạn:
Firebase AI Logic Service Agent (service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com)

Đối với cả dự án hiện tại và dự án mới, nếu bạn truy cập vào Gemini Developer API thông qua Firebase AI Logic, thì bạn không cần làm gì để sử dụng các bản nâng cấp bảo mật này từ giữa năm 2026.

Cách di chuyển khoá API Gemini sang "Khoá uỷ quyền (khoá xác thực)"

Đối với cả dự án hiện có và dự án mới, nếu bạn truy cập vào Gemini Developer API thông qua Firebase AI Logic, thì bạn không cần làm gì để tận dụng các bản nâng cấp bảo mật từ giữa năm 2026 (bao gồm cả việc di chuyển sang "Khoá uỷ quyền (auth)").

Thay mặt cho các nhà phát triển của chúng tôi, Firebase AI Logic sẽ tự động xử lý tất cả các thay đổi bắt buộc về bảo mật để phù hợp với quá trình chuyển đổi của Gemini Developer API nhằm yêu cầu "Khoá uỷ quyền (khoá xác thực)".

Kể từ giữa năm 2026, Firebase AI Logic sẽ không còn cung cấp hoặc sử dụng khoá API Gemini tiêu chuẩn nữa. Thay vào đó, Firebase AI Logic hiện xử lý việc uỷ quyền cho Gemini Developer API bằng cách sử dụng tài khoản dịch vụ do Google quản lý (P4SA) mà chúng tôi tự động cấp cho bạn trong dự án Firebase:
Tác nhân dịch vụ Firebase AI Logic (service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com)

Do có thay đổi này, bạn có thể xem lại và xoá mọi khoá API có tên là Gemini Developer API key (auto created by Firebase). Bạn có thể xoá khoá này trong bảng điều khiển Google Cloud. Hãy xem xét những điều sau trước khi xoá khoá:

• Khoá API Gemini này do Firebase tạo ra chỉ nhằm mục đích sử dụng với Firebase AI Logic, nên bạn có thể xoá khoá này một cách an toàn. Tuy nhiên, trước khi xoá khoá này, bạn vẫn nên kiểm tra để đảm bảo rằng bạn không sử dụng nhầm khoá này với các công cụ khác có thể cấp quyền truy cập vào Gemini Developer API, chẳng hạn như SDK máy chủ GenAI hoặc Genkit. Sau đây là cách kiểm tra mức sử dụng:
  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang của Gemini Developer API, sau đó nhấp vào Quản lý.
  2. Trong thẻ Metrics (Chỉ số), trong trình đơn thả xuống Credentials (Thông tin xác thực), hãy chọn khoá có tên Gemini Developer API key (auto created by Firebase).
  3. Nếu biểu đồ cho thấy không có lượt sử dụng nào kể từ đầu tháng 7 năm 2026 (thời điểm Firebase AI Logic ngừng sử dụng các khoá API này), thì bạn có thể xoá khoá một cách an toàn.
     Tuy nhiên, nếu biểu đồ cho thấy mức sử dụng, thì tức là bạn đang sử dụng khoá này với một công cụ khác và bạn nên đổi tên khoá để thể hiện rõ rằng khoá này đang được dùng với công cụ đó (và không dùng với Firebase AI Logic).
• Đảm bảo rằng bạn không xoá bất kỳ khoá API nào khác có tên chứa đoạn (auto created by Firebase).

Không thêm khoá API Gemini vào toàn bộ mã nguồn của ứng dụng di động hoặc ứng dụng web

Khi sử dụng SDK Firebase AI Logic, bạn không cần khoá API Gemini để cho phép sử dụng Gemini Developer API và bạn không nên thêm khoá API Gemini vào toàn bộ mã nguồn của ứng dụng.

Không sử dụng "khoá API Firebase" làm khoá API Gemini

Tuyệt đối không 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 cho khoá API Firebase.

Khoá API Firebase là khoá API được liệt kê trong tệp hoặc đối tượng cấu hình Firebase 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á đó với các API liên quan đến Firebase (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, đây là giao diện của khoá API Firebase:

Vì bạn cần thêm khoá API Firebase vào toàn bộ mã nguồn của ứng dụng để các API liên quan đến Firebase hoạt động, và vì Gemini Developer API có thể được uỷ cấp quyền thông qua khoá API, nên chúng tôi khuyên bạn 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 của bạn. Nếu làm vậy, bạn sẽ khiến Gemini Developer API có nguy cơ bị lợi dụng.

Cách bảo mật khoá API Gemini