Hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn cách bắt đầu sử dụng API Gemini bằng SDK mà bạn chọn.
Điều kiện tiên quyết
Python
Xem trên AI của Google | Chạy trong Google Colab | Xem sổ tay trên GitHub |
Để hoàn tất quy trình bắt đầu nhanh này trên thiết bị, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:
- Python 3.9 trở lên
- Cài đặt
jupyter
để chạy sổ tay.
Go
Hướng dẫn bắt đầu nhanh này giả định rằng bạn đã quen với việc tạo ứng dụng bằng Go.
Để hoàn tất quy trình bắt đầu nhanh này, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:
- Truy cập phiên bản 1.20 trở lên
Node.js
Hướng dẫn bắt đầu nhanh này giả định rằng bạn đã quen với việc tạo ứng dụng bằng Node.js.
Để hoàn tất quy trình bắt đầu nhanh này, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:
- Node.js phiên bản 18 trở lên
- hải lý/phút
Web
Hướng dẫn bắt đầu nhanh này giả định rằng bạn đã quen với việc sử dụng JavaScript để phát triển ứng dụng web. Hướng dẫn này không phụ thuộc vào khung.
Để hoàn tất quy trình bắt đầu nhanh này, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:
- (Không bắt buộc) Node.js
- Trình duyệt web hiện đại
Phi tiêu (Flutter)
Hướng dẫn bắt đầu nhanh này giả định rằng bạn đã quen với việc tạo ứng dụng bằng Dart.
Để hoàn tất quy trình bắt đầu nhanh này, hãy đảm bảo môi trường phát triển của bạn đáp ứng các yêu cầu sau:
- Dart 3.2.0 trở lên
Swift
Hướng dẫn bắt đầu nhanh này giả định rằng bạn đã quen dùng Xcode để phát triển ứng dụng Swift.
Để hoàn tất quy trình bắt đầu nhanh này, hãy đảm bảo môi trường phát triển và ứng dụng Swift đáp ứng các yêu cầu sau:
- Xcode 15.0 trở lên
- Ứng dụng Swift của bạn phải nhắm đến iOS 15 trở lên hoặc macOS 12 trở lên.
Android
Hướng dẫn bắt đầu nhanh này giả định rằng bạn đã quen với việc sử dụng Android Studio để phát triển ứng dụng Android.
Để hoàn tất quy trình bắt đầu nhanh này, hãy đảm bảo môi trường phát triển và ứng dụng Android của bạn đáp ứng các yêu cầu sau:
- Android Studio (phiên bản mới nhất)
- Ứng dụng Android của bạn phải nhắm đến API cấp 21 trở lên.
Thiết lập khoá API
Để sử dụng API Gemini, bạn cần có một khoá API. Nếu bạn chưa có khoá, hãy tạo khoá trong Google AI Studio.
Sau đó, hãy định cấu hình khoá của bạn.
Python
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Quá trình bắt đầu nhanh này giả định rằng bạn đang truy cập vào khoá API dưới dạng một biến môi trường.
Chỉ định khoá API cho một biến môi trường:
export API_KEY=<YOUR_API_KEY>
Go
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Quá trình bắt đầu nhanh này giả định rằng bạn đang truy cập vào khoá API dưới dạng một biến môi trường.
Chỉ định khoá API cho một biến môi trường:
export API_KEY=<YOUR_API_KEY>
Node.js
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Quá trình bắt đầu nhanh này giả định rằng bạn đang truy cập vào khoá API dưới dạng một biến môi trường.
Chỉ định khoá API cho một biến môi trường:
export API_KEY=<YOUR_API_KEY>
Web
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Thay vào đó, bạn nên truyền khoá API đến ứng dụng ngay trước khi khởi chạy mô hình.
Quá trình bắt đầu nhanh này giả định rằng bạn đang truy cập khoá API dưới dạng một hằng số chung.
Phi tiêu (Flutter)
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Quá trình bắt đầu nhanh này giả định rằng bạn đang truy cập vào khoá API dưới dạng một biến môi trường của quy trình. Nếu đang phát triển một ứng dụng Flutter, bạn có thể sử dụng String.fromEnvironment
và truyền --dart-define=API_KEY=$API_KEY
đến flutter build
hoặc flutter run
để biên dịch bằng khoá API, vì môi trường xử lý sẽ khác nhau khi chạy ứng dụng.
Swift
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Một lựa chọn khác là lưu trữ khoá này trong tệp GenerativeAI-Info.plist
, sau đó đọc khoá API qua tệp .plist
. Hãy nhớ đặt tệp .plist
này vào thư mục gốc của ứng dụng và loại trừ tệp này khỏi chế độ quản lý phiên bản.
enum APIKey {
// Fetch the API key from `GenerativeAI-Info.plist`
static var `default`: String {
guard let filePath = Bundle.main.path(forResource: "GenerativeAI-Info", ofType: "plist")
else {
fatalError("Couldn't find file 'GenerativeAI-Info.plist'.")
}
let plist = NSDictionary(contentsOfFile: filePath)
guard let value = plist?.object(forKey: "API_KEY") as? String else {
fatalError("Couldn't find key 'API_KEY' in 'GenerativeAI-Info.plist'.")
}
if value.starts(with: "_") {
fatalError(
"Follow the instructions at https://ai.google.dev/tutorials/setup to get an API key."
)
}
return value
}
}
Android
Bạn không nên kiểm tra khoá API trong hệ thống quản lý phiên bản. Thay vào đó, bạn nên lưu trữ tệp này trong tệp local.properties
(nằm trong thư mục gốc của dự án nhưng bị loại trừ khỏi quy trình quản lý phiên bản), sau đó sử dụng trình bổ trợ Secrets Gradle cho Android để đọc khoá API dưới dạng biến Cấu hình bản dựng.
Kotlin:
// Access your API key as a Build Configuration variable
val apiKey = BuildConfig.apiKey
Java:
// Access your API key as a Build Configuration variable
String apiKey = BuildConfig.apiKey;
Nếu muốn xem cách triển khai trình bổ trợ Secrets Gradle cho Gradle, bạn có thể tham khảo ứng dụng mẫu của SDK này hoặc sử dụng bản xem trước mới nhất của Android Studio Iguana có mẫu Gemini API Starter (bao gồm cả tệp local.properties
để giúp bạn bắt đầu).
Cài đặt SDK
Python
SDK Python cho API Gemini có trong gói google-generativeai
. Cài đặt phần phụ thuộc bằng pip:
pip install -q -U google-generativeai
Go
Để sử dụng API Gemini trong ứng dụng của riêng mình, bạn cần get
gói Go SDK trong thư mục mô-đun:
go get github.com/google/generative-ai-go
Node.js
Để sử dụng API Gemini trong ứng dụng của riêng mình, bạn cần cài đặt gói GoogleGenerativeAI
cho Node.js:
npm install @google/generative-ai
Web
Để sử dụng API Gemini trong ứng dụng web của riêng bạn, hãy nhập @google/generative-ai
:
<script type="importmap">
{
"imports": {
"@google/generative-ai": "https://esm.run/@google/generative-ai"
}
}
</script>
Phi tiêu (Flutter)
Để sử dụng API Gemini trong ứng dụng của riêng bạn, bạn cần add
gói google_generative_ai
vào ứng dụng Dart hoặc Flutter của mình:
Phi tiêu:
dart pub add google_generative_ai
Xoè:
flutter pub add google_generative_ai
Swift
Để sử dụng API Gemini trong ứng dụng Swift của riêng bạn, hãy thêm gói GoogleGenerativeAI
vào ứng dụng của bạn:
Trong Xcode, hãy nhấp chuột phải vào dự án của bạn trong trình điều hướng dự án.
Chọn Add Packages (Thêm gói) trong trình đơn theo bối cảnh.
Trong hộp thoại Add Packages (Thêm gói), hãy dán URL của gói vào thanh tìm kiếm:
none https://github.com/google/generative-ai-swift
Nhấp vào Thêm gói. Giờ đây, Xcode sẽ thêm gói
GoogleGenerativeAI
vào dự án của bạn.
Android
Trong tệp cấu hình Gradle mô-đun (cấp ứng dụng) (như
<project>/<app-module>/build.gradle.kts
), hãy thêm phần phụ thuộc cho SDK AI của Google dành cho Android:Kotlin:
dependencies { // add the dependency for the Google AI client SDK for Android implementation("com.google.ai.client.generativeai:generativeai:0.3.0") }
Java:
Đối với Java, bạn cần thêm hai thư viện bổ sung.
dependencies { // add the dependency for the Google AI client SDK for Android implementation("com.google.ai.client.generativeai:generativeai:0.3.0") // Required for one-shot operations (to use `ListenableFuture` from Guava Android) implementation("com.google.guava:guava:31.0.1-android") // Required for streaming operations (to use `Publisher` from Reactive Streams) implementation("org.reactivestreams:reactive-streams:1.0.4") }
Đồng bộ hoá dự án Android với các tệp Gradle.
Khởi động mô hình tạo sinh
Python
Để có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần nhập và khởi chạy mô hình tạo sinh.
import google.generativeai as genai
genai.configure(api_key=os.environ["API_KEY"])
model = genai.GenerativeModel('gemini-pro')
Go
Để có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần nhập và khởi chạy mô hình tạo sinh.
import "github.com/google/generative-ai-go/genai"
import "google.golang.org/api/option"
ctx := context.Background()
// Access your API key as an environment variable (see "Set up your API key" above)
client, err := genai.NewClient(ctx, option.WithAPIKey(os.Getenv("API_KEY")))
if err != nil {
log.Fatal(err)
}
defer client.Close()
// For text-only input, use the gemini-pro model
model := client.GenerativeModel("gemini-pro")
Node.js
Để có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần nhập và khởi chạy mô hình tạo sinh.
const { GoogleGenerativeAI } = require("@google/generative-ai");
// Access your API key as an environment variable (see "Set up your API key" above)
const genAI = new GoogleGenerativeAI(process.env.API_KEY);
// ...
// For text-only input, use the gemini-pro model
const model = genAI.getGenerativeModel({ model: "gemini-pro"});
// ...
Web
Để có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần nhập và khởi chạy mô hình tạo sinh.
<html>
<body>
<!-- ... Your HTML and CSS -->
<!-- Import @google/generative-ai, as shown above. -->
<script type="module">
import { GoogleGenerativeAI } from "@google/generative-ai";
// Fetch your API_KEY
const API_KEY = "...";
// Access your API key (see "Set up your API key" above)
const genAI = new GoogleGenerativeAI(API_KEY);
// ...
// For text-only input, use the gemini-pro model
const model = genAI.getGenerativeModel({ model: "gemini-pro"});
// ...
</script>
</body>
</html>
Phi tiêu (Flutter)
Để có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần nhập và khởi chạy mô hình tạo sinh.
import 'package:google_generative_ai/google_generative_ai.dart';
// Access your API key as an environment variable (see "Set up your API key" above)
final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
print('No \$API_KEY environment variable');
exit(1);
}
// For text-only input, use the gemini-pro model
final model = GenerativeModel(model: 'gemini-pro', apiKey: apiKey);
Swift
Trước khi có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần khởi chạy mô hình tạo sinh.
Nhập mô-đun
GoogleAI
:import GoogleGenerativeAI
Khởi động mô hình tạo sinh:
// For text-only input, use the gemini-pro model // Access your API key from your on-demand resource .plist file (see "Set up your API key" above) let model = GenerativeModel(name: "gemini-pro", apiKey: APIKey.default)
Android
Để có thể thực hiện bất kỳ lệnh gọi API nào, bạn cần khởi động đối tượng GenerativeModel
:
Kotlin:
val generativeModel = GenerativeModel(
// For text-only input, use the gemini-pro model
modelName = "gemini-pro",
// Access your API key as a Build Configuration variable (see "Set up your API key" above)
apiKey = BuildConfig.apiKey
)
Java:
Đối với Java, bạn cũng cần khởi chạy đối tượng GenerativeModelFutures
.
// For text-only input, use the gemini-pro model
GenerativeModel gm = new GenerativeModel(/* modelName */ "gemini-pro",
// Access your API key as a Build Configuration variable (see "Set up your API key" above)
/* apiKey */ BuildConfig.apiKey);
// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);
Tạo văn bản
Python
response = model.generate_content("Write a story about a magic backpack.")
print(response.text)
Go
resp, err := model.GenerateContent(ctx, genai.Text("Write a story about a magic backpack."))
if err != nil {
log.Fatal(err)
}
Node.js
async function run() {
const prompt = "Write a story about a magic backpack."
const result = await model.generateContent(prompt);
const response = await result.response;
const text = response.text();
console.log(text);
}
run();
Web
async function run() {
const prompt = "Write a story about a magic backpack."
const result = await model.generateContent(prompt);
const response = await result.response;
const text = response.text();
console.log(text);
}
run();
Phi tiêu (Flutter)
void main() async {
// Access your API key as an environment variable (see "Set up your API key" above)
final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
print('No \$API_KEY environment variable');
exit(1);
}
// For text-only input, use the gemini-pro model
final model = GenerativeModel(model: 'gemini-pro', apiKey: apiKey);
final content = [Content.text('Write a story about a magic backpack.')];
final response = await model.generateContent(content);
print(response.text);
}
Swift
let prompt = "Write a story about a magic backpack."
let response = try await model.generateContent(prompt)
if let text = response.text {
print(text)
}
Android
Kotlin:
Lưu ý rằng generateContent()
là một hàm tạm ngưng và cần được gọi từ phạm vi Coroutine. Nếu bạn chưa hiểu rõ về Coroutine, hãy đọc bài viết Coroutine Kotlin trên Android.
val prompt = "Write a story about a magic backpack."
val response = generativeModel.generateContent(prompt)
print(response.text)
Java:
Xin lưu ý rằng generateContent()
trả về ListenableFuture
. Nếu bạn chưa hiểu rõ về API này, hãy xem tài liệu của Android về cách Sử dụng ListenableFuture
.
Content content = new Content.Builder()
.addText("Write a story about a magic backpack.")
.build();
Executor executor = // ...
ListenableFuture<GenerateContentResponse> response = model.generateContent(content);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
@Override
public void onSuccess(GenerateContentResponse result) {
String resultText = result.getText();
System.out.println(resultText);
}
@Override
public void onFailure(Throwable t) {
t.printStackTrace();
}
}, executor);
Bước tiếp theo
Để tìm hiểu thêm về cách làm việc với API Gemini, hãy xem hướng dẫn dành cho ngôn ngữ bạn chọn.
Bạn cũng có thể dùng các lệnh curl
để dùng thử API Gemini:
Nếu mới sử dụng các mô hình AI tạo sinh, bạn nên xem hướng dẫn về khái niệm và tổng quan về API Genmini trước khi thử hướng dẫn bắt đầu nhanh.