البدء السريع لواجهة برمجة تطبيقات Gemini

يوضّح لك دليل البدء السريع هذا كيفية بدء استخدام واجهة برمجة التطبيقات Gemini API باستخدام حزمة SDK التي تختارها.

Python Node.js Go Dart (Flutter) Android Swift الويب REST

المتطلبات الأساسية

يفترض دليل البدء السريع هذا أنّك على دراية باستخدام "استوديو Android" ل تطوير تطبيقات Android.

لإكمال عملية الإعداد السريع هذه، تأكَّد من أنّ بيئة التطوير و تطبيق Android يستوفيان المتطلبات التالية:

• "استوديو Android" (أحدث إصدار)
• يجب أن يستهدف تطبيق Android المستوى 21 من واجهة برمجة التطبيقات أو الإصدارات الأحدث.

استخدام Gemini على الجهاز

تتيح لك حزمة تطوير البرامج (SDK) لتطبيقات Android المُوضَّحة في هذا الدليل التعليمي الوصول إلى نماذج Gemini التي تُشغَّل على خوادم Google. بالنسبة إلى حالات الاستخدام التي تتضمن معالجة البيانات الحسّاسة أو التوفّر بلا إنترنت أو توفير التكاليف في مسارات المستخدِمين المستخدَمة بشكل متكرّر، ننصحك بالوصول إلى Gemini Nano الذي يعمل على الجهاز. لمزيد من التفاصيل، يُرجى الرجوع إلى صفحة Android (على الجهاز).

تثبيت حزمة تطوير البرامج (SDK) لواجهة برمجة التطبيقات Gemini API

1. في ملف إعدادات Gradle للوحدة (على مستوى التطبيق) (مثل <project>/<app-module>/build.gradle.kts)، أضِف الاعتمادية ل حزمة تطوير البرامج (SDK) لتكنولوجيات الذكاء الاصطناعي من Google لنظام التشغيل 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

   بالنسبة إلى 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 (الذي يقع في الدليل الجذر لمشروعك، ولكن تم استبعاده من التحكّم في الإصدار)، ثم استخدام مكوّن Gradle الإضافي لنظام Android المخصّص للسرّية لقراءة مفتاح واجهة برمجة التطبيقات كمتغيّر لإعدادات التصميم.

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

إذا أردت الاطّلاع على عملية تنفيذ المكوّن الإضافي Secrets Gradle، يمكنك مراجعة نموذج التطبيق لحزمة تطوير البرامج (SDK) هذه أو استخدام أحدث إصدار مبكر من Android Studio Iguana الذي يتضمّن ملف Gemini API Starter (الذي يتضمّن ملف local.properties لمساعدتك في البدء).

استيراد المكتبة

استورِد مكتبة الذكاء الاصطناعي التوليدي من 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;

تقديم طلبك الأول

استخدِم الطريقة generateContent لإنشاء نص.

    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

الخطوات التالية

بعد الانتهاء من إعداد طلباتك إلى Gemini API، يمكنك استخدام مجموعة كاملة من إمكانات Gemini API لإنشاء تطبيقاتك ومسارات عملك. لبدء استخدام إمكانات Gemini API، يُرجى الاطّلاع على الأدلة التالية:

• إنشاء النصوص
• الرؤية
• الصوت
• سياق طويل

للحصول على مستندات مفصّلة حول طرق Gemini API ومَعلمات الطلبات، يُرجى الاطّلاع على الأدلة في مرجع واجهة برمجة التطبيقات.