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ıcı tamamlamak için geliştirme ortamınızın ve Android uygulamanızın aşağıdaki koşulları 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ğitimde açıklanan Android 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.

Google AI SDK'sını yükleme

  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 ek kitaplık 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 uygulanmasını görmek istiyorsanız bu SDK'nın örnek uygulamasını inceleyebilir veya Android Studio Iguana'nın en son önizlemesini kullanabilirsiniz. Bu önizlemede, Gemini API Başlatıcı şablonu (başlamak için local.properties dosyasını içerir) bulunur.

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ışı hakkında bilginiz yoksa Android'de Kotlin Görev Akışı 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 belgelerine bakı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.