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

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


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

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

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

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

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

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

Gemini API 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 प्लग इन लागू होने के बारे में जानकारी पाने के लिए, इस SDK टूल के लिए सैंपल ऐप्लिकेशन देखें या 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 के तरीकों और अनुरोध पैरामीटर के बारे में ज़्यादा जानकारी के लिए, एपीआई रेफ़रंस में दी गई गाइड देखें.