Gemini API क्विकस्टार्ट

इस शुरुआती लेख में, अपनी पसंद के एसडीके का इस्तेमाल करके Gemini API का इस्तेमाल शुरू करने का तरीका बताया गया है.


ज़रूरी शर्तें

इस क्विकस्टार्ट में यह माना गया है कि आपको Android ऐप्लिकेशन बनाने के लिए, Android Studio का इस्तेमाल करने का तरीका पता है.

यह शुरुआती तरीका पूरा करने के लिए, पक्का करें कि आपका डेवलपमेंट एनवायरमेंट और Android ऐप्लिकेशन, इन ज़रूरी शर्तों को पूरा करता हो:

  • Android Studio (नया वर्शन)
  • आपके Android ऐप्लिकेशन को एपीआई लेवल 21 या उसके बाद के वर्शन को टारगेट करना होगा.

डिवाइस पर Gemini को ऐक्सेस करना

इस ट्यूटोरियल में बताए गए Android के लिए क्लाइंट SDK टूल की मदद से, Google के सर्वर पर चलने वाले Gemini मॉडल को ऐक्सेस किया जा सकता है. संवेदनशील डेटा को प्रोसेस करने, ऑफ़लाइन उपलब्धता या अक्सर इस्तेमाल किए जाने वाले उपयोगकर्ता फ़्लो के लिए लागत में बचत करने के लिए, Gemini Nano का इस्तेमाल करें. यह डिवाइस पर चलता है. ज़्यादा जानकारी के लिए, Android (डिवाइस पर) पेज देखें.

Google AI SDK इंस्टॉल करना

  1. अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle कॉन्फ़िगरेशन फ़ाइल (जैसे कि <project>/<app-module>/build.gradle.kts) में, Android के लिए Google AI SDK टूल की डिपेंडेंसी जोड़ें:

    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 के लिए, आपको दो अतिरिक्त लाइब्रेरी जोड़नी होंगी.

    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 प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.

पुष्टि करने की सुविधा सेट अप करना

Gemini API की पुष्टि करने का सबसे आसान तरीका, एपीआई पासकोड को कॉन्फ़िगर करना है. इस बारे में इस सेक्शन में बताया गया है. अगर आपको ऐक्सेस कंट्रोल की ज़्यादा सख्त सुविधा चाहिए, तो इसके बजाय OAuth का इस्तेमाल करें.

अगर आपके पास पहले से कोई एपीआई पासकोड नहीं है, तो Google AI Studio में जाकर एक पासकोड बनाएं.

Google AI Studio से एपीआई पासकोड पाना

इसके बाद, अपनी कुंजी कॉन्फ़िगर करें.

हमारा सुझाव है कि आप अपने वर्शन कंट्रोल सिस्टम में एपीआई पासकोड को न डालें. इसके बजाय, आपको इसे किसी local.properties फ़ाइल में सेव करना चाहिए. यह फ़ाइल आपके प्रोजेक्ट की रूट डायरेक्ट्री में होती है, लेकिन इसे वर्शन कंट्रोल से बाहर रखा जाता है. इसके बाद, अपनी एपीआई कुंजी को बिल्ड कॉन्फ़िगरेशन वैरिएबल के तौर पर पढ़ने के लिए, Android के लिए Secrets Gradle प्लग इन का इस्तेमाल करें.

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 प्लग इन को लागू करने का तरीका देखना है, तो इस एसडीके टूल के लिए, सैंपल ऐप्लिकेशन की समीक्षा करें या Android Studio Iguana के नए प्रीव्यू का इस्तेमाल करें. इसमें Gemini API Starter टेंप्लेट शामिल है. इसमें आपको शुरुआत करने के लिए local.properties फ़ाइल भी मिलती है.

लाइब्रेरी इंपोर्ट करना

Google की जनरेटिव एआई लाइब्रेरी इंपोर्ट करें.

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;

अपना पहला अनुरोध करना

टेक्स्ट जनरेट करने के लिए, generateContent वाला तरीका इस्तेमाल करें.

Kotlin

generateContent() एक सस्पेंड फ़ंक्शन है और इसे कोरूटीन स्कोप से कॉल करना ज़रूरी है. अगर आपको कोरूटीन के बारे में जानकारी नहीं है, तो Android पर Kotlin कोरूटीन लेख पढ़ें.

    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 दिखाता है. अगर आपको इस एपीआई के बारे में जानकारी नहीं है, तो ListenableFuture का इस्तेमाल करने के बारे में Android दस्तावेज़ देखें.

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

आगे क्या करना है

अब आपके पास Gemini API से अनुरोध करने की सुविधा है. इसलिए, अपने ऐप्लिकेशन और वर्कफ़्लो बनाने के लिए, Gemini API की सभी सुविधाओं का इस्तेमाल किया जा सकता है. Gemini API की सुविधाओं का इस्तेमाल शुरू करने के लिए, ये गाइड देखें:

Gemini API के तरीकों और अनुरोध पैरामीटर के बारे में ज़्यादा जानकारी के लिए, एपीआई रेफ़रंस में दी गई गाइड देखें.