Hướng dẫn này cho bạn biết cách bắt đầu thực hiện lệnh gọi đến Vertex AI Gemini API ngay từ ứng dụng của bạn bằng cách sử dụng SDK Vertex AI in Firebase cho nền tảng mà bạn đã chọn.
Các tuỳ chọn khác để làm việc với Gemini API
Bạn có thể tuỳ ý thử nghiệm phiên bản "Google AI" thay thế của Gemini API
Nhận quyền truy cập miễn phí (trong giới hạn và nếu có) bằng cách sử dụng Google AI Studio và SDK ứng dụng Google AI. Bạn chỉ nên sử dụng các SDK này để tạo bản mô hình trong ứng dụng dành cho thiết bị di động và web.Sau khi bạn đã quen thuộc với cách hoạt động của Gemini API, hãy chuyển sang SDK Vertex AI in Firebase của chúng tôi (tài liệu này). SDK này có nhiều tính năng bổ sung quan trọng đối với ứng dụng web và ứng dụng di động, chẳng hạn như bảo vệ API khỏi hành vi sử dụng sai trái bằng cách sử dụng Firebase App Check và hỗ trợ các tệp phương tiện lớn trong yêu cầu.
Có thể gọi Vertex AI Gemini API phía máy chủ (chẳng hạn như với Python, Node.js hoặc Go)
Sử dụng SDK Vertex AI phía máy chủ, Firebase Genkit hoặc Firebase Extensions cho Gemini API.
Xin lưu ý rằng bạn cũng có thể sử dụng hướng dẫn này để bắt đầu truy cập vào các mô hình Imagen bằng SDK Vertex AI in Firebase.
Điều kiện tiên quyết
Hướng dẫn này giả định rằng bạn đã quen thuộc với việc phát triển ứng dụng bằng Flutter.
Đảm bảo rằng môi trường phát triển và ứng dụng Flutter của bạn đáp ứng các yêu cầu sau:
- Dart 3.2.0 trở lên
(Không bắt buộc) Xem ứng dụng mẫu.
Bạn có thể nhanh chóng dùng thử SDK, xem cách triển khai đầy đủ nhiều trường hợp sử dụng hoặc sử dụng ứng dụng mẫu nếu không có ứng dụng Flutter của riêng mình. Để sử dụng ứng dụng mẫu, bạn cần kết nối ứng dụng đó với một dự án Firebase.
Bước 1: Thiết lập dự án Firebase và kết nối ứng dụng với Firebase
Nếu bạn đã có một dự án Firebase và một ứng dụng được kết nối với Firebase
Trong bảng điều khiển Firebase, hãy chuyển đến trang Tạo bằng Gemini.
Nhấp vào thẻ Vertex AI in Firebase để khởi chạy quy trình công việc giúp bạn hoàn thành các nhiệm vụ sau:
Nâng cấp dự án để sử dụng Gói giá linh hoạt (trả tiền theo mức dùng).
Bật các API bắt buộc trong dự án (Vertex AI API và Vertex AI in Firebase API).
Tiếp tục bước tiếp theo trong hướng dẫn này để thêm SDK vào ứng dụng.
Nếu bạn chưa có dự án Firebase và ứng dụng được kết nối với Firebase
Thiết lập dự án Firebase
Đăng nhập vào bảng điều khiển Firebase.
Nhấp vào Tạo dự án, rồi sử dụng một trong các tuỳ chọn sau:
Cách 1: Tạo một dự án Firebase hoàn toàn mới (và tự động tạo dự án Google Cloud cơ bản của dự án đó) bằng cách nhập tên dự án mới ở bước đầu tiên trong quy trình "Tạo dự án".
Cách 2: "Thêm Firebase" vào dự án Google Cloud hiện có bằng cách chọn tên dự án Google Cloud trong trình đơn thả xuống ở bước đầu tiên của quy trình "Tạo dự án".
Xin lưu ý rằng khi được nhắc, bạn không cần thiết lập Google Analytics để sử dụng SDK Vertex AI in Firebase.
Trong bảng điều khiển Firebase, hãy chuyển đến trang Tạo bằng Gemini.
Nhấp vào thẻ Vertex AI in Firebase để khởi chạy quy trình công việc giúp bạn hoàn thành các nhiệm vụ sau:
Nâng cấp dự án để sử dụng Gói giá linh hoạt (trả tiền theo mức dùng).
Bật các API bắt buộc trong dự án (Vertex AI API và Vertex AI in Firebase API).
Kết nối ứng dụng với Firebase
Cài đặt các công cụ dòng lệnh bắt buộc:
Nếu bạn chưa cài đặt, hãy cài đặt CLI Firebase.
Đăng nhập vào Firebase bằng Tài khoản Google của bạn bằng cách chạy lệnh sau:
firebase login
Cài đặt FlutterFire CLI bằng cách chạy lệnh sau từ bất kỳ thư mục nào:
dart pub global activate flutterfire_cli
Định cấu hình ứng dụng để sử dụng Firebase:
Sử dụng FlutterFire CLI để định cấu hình ứng dụng Flutter kết nối với Firebase.
Từ thư mục dự án Flutter, hãy chạy lệnh sau để bắt đầu quy trình làm việc về cấu hình ứng dụng:
flutterfire configure
Quy trình công việc
flutterfire configure
này có tác dụng gì?Quy trình công việc
flutterfire configure
thực hiện những việc sau:Yêu cầu bạn chọn các nền tảng (iOS, Android, Web) được hỗ trợ trong ứng dụng Flutter. Đối với mỗi nền tảng đã chọn, FlutterFire CLI sẽ tạo một ứng dụng Firebase mới trong dự án Firebase.
Bạn có thể chọn sử dụng một dự án Firebase hiện có hoặc tạo một dự án Firebase mới. Nếu bạn đã đăng ký ứng dụng trong một dự án Firebase hiện có, thì FlutterFire CLI sẽ cố gắng so khớp các ứng dụng đó dựa trên cấu hình dự án Flutter hiện tại của bạn.
Tạo tệp cấu hình Firebase (
firebase_options.dart
) và thêm tệp đó vào thư mụclib/
của ứng dụng Flutter.
Trong các bước tiếp theo của hướng dẫn này, bạn sẽ thêm SDK Vertex AI in Firebase vào ứng dụng và hoàn tất quá trình khởi chạy bắt buộc dành riêng cho việc sử dụng SDK và Gemini API.
Bước 2: Thêm SDK
Sau khi thiết lập dự án Firebase và kết nối ứng dụng với Firebase (xem bước trước), giờ đây, bạn có thể thêm SDK Vertex AI in Firebase vào ứng dụng.
Trình bổ trợ Vertex AI in Firebase cho Flutter (firebase_vertexai
) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini và Imagen.
Từ thư mục dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ cốt lõi và trình bổ trợ Vertex AI in Firebase:
flutter pub add firebase_core && flutter pub add firebase_vertexai
Trong tệp
lib/main.dart
, hãy nhập trình bổ trợ lõi Firebase, trình bổ trợ Vertex AI in Firebase và tệp cấu hình mà bạn đã tạo trước đó:import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_vertexai/firebase_vertexai.dart'; import 'firebase_options.dart';
Ngoài ra, trong tệp
lib/main.dart
, hãy khởi chạy Firebase bằng đối tượngDefaultFirebaseOptions
do tệp cấu hình xuất:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Tạo lại ứng dụng Flutter:
flutter run
Bước 3: Khởi chạy dịch vụ Vertex AI và mô hình tạo sinh
Trước khi có thể thực hiện bất kỳ lệnh gọi API nào và nhắc một mô hình Gemini, bạn cần khởi chạy dịch vụ Vertex AI và mô hình tạo sinh.
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
// Initialize FirebaseApp
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');
Sau khi bạn hoàn tất hướng dẫn bắt đầu này, hãy tìm hiểu cách chọn một mô hình và (không bắt buộc) một vị trí phù hợp với trường hợp sử dụng và ứng dụng của bạn.
Bước 4: Gửi yêu cầu lời nhắc đến một mô hình
Giờ đây, khi đã kết nối ứng dụng với Firebase, thêm SDK và khởi chạy dịch vụ Vertex AI cũng như mô hình tạo sinh, bạn đã sẵn sàng gửi yêu cầu lời nhắc đến mô hình Gemini.
Bạn có thể sử dụng generateContent()
để tạo văn bản từ một yêu cầu câu lệnh chỉ có văn bản:
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');
// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];
// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);
Bạn có thể làm gì khác?
Tìm hiểu thêm về các mẫu được hỗ trợ
Tìm hiểu về các mô hình có sẵn cho nhiều trường hợp sử dụng, cũng như hạn mức và giá của các mô hình đó.
Thử các tính năng khác của Gemini API
- Tìm hiểu thêm về cách tạo văn bản từ lời nhắc chỉ có văn bản, bao gồm cả cách truyền trực tuyến nội dung phản hồi.
- Tạo văn bản từ câu lệnh đa phương thức (bao gồm văn bản, hình ảnh, tệp PDF, video và âm thanh).
- Xây dựng cuộc trò chuyện nhiều lượt (trò chuyện).
- Tạo kết quả có cấu trúc (như JSON) từ cả lời nhắc bằng văn bản và đa phương thức.
- Sử dụng tính năng gọi hàm để kết nối các mô hình tạo sinh với hệ thống và thông tin bên ngoài.
Tìm hiểu cách kiểm soát việc tạo nội dung
- Tìm hiểu về thiết kế câu lệnh, bao gồm cả các phương pháp hay nhất, chiến lược và câu lệnh mẫu.
- Định cấu hình các tham số mô hình như nhiệt độ và mã thông báo đầu ra tối đa (đối với Gemini) hoặc tỷ lệ khung hình và tạo người (đối với Imagen).
- Sử dụng chế độ cài đặt an toàn để điều chỉnh khả năng nhận được những câu trả lời có thể bị coi là có hại.
Gửi ý kiến phản hồi về trải nghiệm của bạn với Vertex AI in Firebase