Bắt đầu nhanh API Gemini

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 Gemini API bằng SDK bạn chọn.

Python Node.js Go Dart (Flutter) Android Swift Web REST

Điều kiện tiên quyết

Phần bắt đầu nhanh này giả định rằng bạn đã quen thuộc với việc sử dụng Android Studio để phát triển ứng dụng Android.

Để hoàn tất hướng dẫn nhanh này, hãy đảm bảo rằng 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.

Cân nhắc truy cập Gemini trên thiết bị

SDK ứng dụng cho Android được mô tả trong hướng dẫn này cho phép bạn truy cập vào các mô hình Gemini chạy trên máy chủ của Google. Đối với các trường hợp sử dụng liên quan đến việc xử lý dữ liệu nhạy cảm, khả năng hoạt động ngoại tuyến hoặc để tiết kiệm chi phí cho các luồng người dùng thường xuyên sử dụng, bạn nên cân nhắc sử dụng Gemini Nano chạy trên thiết bị. Để biết thêm thông tin chi tiết, hãy tham khảo trang Android (trên thiết bị).

Cài đặt SDK Gemini API

1. 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.7.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.7.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")
   }
   

2. Đồng bộ hoá dự án Android với các tệp Gradle.

Thiết lập tính năng xác thực

Cách dễ nhất để xác thực API Gemini là định cấu hình khoá API, như mô tả trong phần này. Nếu cần các chế độ kiểm soát quyền truy cập nghiêm ngặt hơn, bạn có thể sử dụng OAuth.

Nếu bạn chưa có khoá API, hãy tạo khoá API trong Google AI Studio.

Lấy khoá API từ Google AI Studio

Sau đó, hãy định cấu hình khoá của bạn.

Bạn không nên kiểm tra khoá API vào hệ thống quản lý phiên bản. Thay vào đó, bạn nên lưu trữ khoá 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 tính năng kiểm soát 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.

// Access your API key as a Build Configuration variable
val apiKey = BuildConfig.apiKey

// 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, bạn có thể xem lại ứng dụng mẫu cho 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 tệp local.properties để bạn bắt đầu).

Nhập thư viện

Nhập thư viện AI tạo sinh của Google.

// other imports...
import com.google.ai.client.generativeai.GenerativeModel

// other imports...
import com.google.ai.client.generativeai.GenerativeModel;
import com.google.ai.client.generativeai.java.GenerativeModelFutures;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.type.GenerateContentResponse;

Tạo yêu cầu đầu tiên

Sử dụng phương thức generateContent để tạo văn bản.

    val generativeModel =
    GenerativeModel(
        // Specify a Gemini model appropriate for your use case
        modelName = "gemini-1.5-flash",
        // Access your API key as a Build Configuration variable (see "Set up your API key" above)
        apiKey = BuildConfig.apiKey)

val prompt = "Write a story about a magic backpack."
val response = generativeModel.generateContent(prompt)
print(response.text)
text_generation.kt

    // Specify a Gemini model appropriate for your use case
GenerativeModel gm =
    new GenerativeModel(
        /* modelName */ "gemini-1.5-flash",
        // Access your API key as a Build Configuration variable (see "Set up your API key"
        // above)
        /* apiKey */ BuildConfig.apiKey);
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

Content content =
    new Content.Builder().addText("Write a story about a magic backpack.").build();

// For illustrative purposes only. You should use an executor that fits your needs.
Executor executor = Executors.newSingleThreadExecutor();

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);
text_generation.java

Bước tiếp theo

Giờ đây, khi đã thiết lập để gửi yêu cầu đến API Gemini, bạn có thể sử dụng toàn bộ các tính năng của API Gemini để xây dựng ứng dụng và quy trình công việc. Để bắt đầu sử dụng các tính năng của Gemini API, hãy xem những hướng dẫn sau:

• Tạo văn bản
• Vision
• Âm thanh
• Bối cảnh dài

Để biết tài liệu chuyên sâu về các phương thức và tham số yêu cầu của API Gemini, hãy xem hướng dẫn trong tài liệu tham khảo API.