Gemini API hızlı başlangıç kılavuzu

Bu hızlı başlangıç kılavuzunda, tercih ettiğiniz SDK'yı kullanarak Gemini API'yi nasıl kullanmaya başlayacağınız gösterilmektedir.


Ön koşullar

Bu hızlı başlangıç kılavuzunda, Android uygulamaları geliştirmek için Android Studio'yu kullanabildiğiniz varsayılmaktadır.

Bu hızlı başlangıç kılavuzunu tamamlamak için geliştirme ortamınızın ve Android uygulamanızın aşağıdaki gereksinimleri karşıladığından emin olun:

  • Android Studio (son sürüm)
  • Android uygulamanız, API düzeyi 21 veya üstünü hedeflemelidir.

Gemini'ye cihazınızdan erişebilirsiniz.

Bu eğiticide açıklanan Android için istemci SDK'sı, Google'ın sunucularında çalışan Gemini modellerine erişmenizi sağlar. Hassas verilerin işlenmesini, çevrimdışı kullanılabilirliği veya sık kullanılan kullanıcı akışlarında maliyet tasarrufu sağlamaya yönelik kullanım alanları için cihaz üzerinde çalışan Gemini Nano'ya erişebilirsiniz. Daha fazla bilgi için Android (cihaz üzerinde) sayfasına bakın.

Gemini API SDK'sını yükleyin

  1. Modülünüzün (uygulama düzeyinde) Gradle yapılandırma dosyanıza (<project>/<app-module>/build.gradle.kts gibi) Android için Google AI SDK'sına ait bağımlılık ekleyin:

    Kotlin 

    dependencies {

  // add the dependency for the Google AI client SDK for Android
  implementation("com.google.ai.client.generativeai:generativeai:0.7.0")
}

    Java

    Java için iki kitaplık daha eklemeniz gerekir.

    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. Android projenizi Gradle dosyalarıyla senkronize edin.

Kimlik doğrulamayı ayarlama

Gemini API'de kimlik doğrulamanın en kolay yolu, bu bölümde açıklandığı gibi bir API anahtarı yapılandırmaktır. Daha katı erişim denetimlerine ihtiyacınız varsa bunun yerine OAuth'u kullanabilirsiniz.

API anahtarınız yoksa Google AI Studio'da bir anahtar oluşturun.

Google AI Studio'dan API anahtarı alma

Ardından anahtarınızı yapılandırın.

API anahtarını sürüm kontrol sisteminize kontrol etmemeniz önemle tavsiye edilir. Bunun yerine, API anahtarınızı bir local.propertiesdosyasında (projenizin kök dizininde bulunur ancak sürüm kontrolünden hariç tutulur) saklamanız ve ardından API anahtarınızı bir Derleme Yapılandırması değişkeni olarak okumak için Android için Gizli Gradle eklentisini kullanmanız gerekir.

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;

Secrets Gradle eklentisinin nasıl uygulandığını görmek istiyorsanız bu SDK için örnek uygulamayı inceleyebilir veya Android Studio Iguana'nın en son önizlemesini kullanabilirsiniz. Bu önizlemede Gemini API Starter şablonu bulunur (başlamanızı sağlayacak local.properties dosyasını içerir).

Kitaplığı içe aktarma

Google üretken yapay zeka kitaplığını içe aktarın.

Kotlin 

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

Java 

// 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;

İlk isteğinizi gönderin

Metin oluşturmak için generateContent yöntemini kullanın.

Kotlin

generateContent(), askıya alma işlevidir ve bir Coroutine kapsamından çağrılması gerekir. Görev akışları hakkında bilginiz yoksa Android'de Kotlin Görev Akışları başlıklı makaleyi okuyun.

    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

Java

generateContent(), ListenableFuture döndürür. Bu API hakkında bilginiz yoksa ListenableFuture kullanma hakkındaki Android dokümanlarına göz atın.

    // 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

Sırada ne var?

Gemini API'ye istek göndermeye hazır olduğunuza göre, uygulamalarınızı ve iş akışlarınızı oluşturmak için Gemini API'nin tüm özelliklerini kullanabilirsiniz. Gemini API özelliklerini kullanmaya başlamak için aşağıdaki kılavuzları inceleyin:

Gemini API yöntemleri ve istek parametreleriyle ilgili ayrıntılı dokümanlar için API referansında yer alan kılavuzlara bakın.