Gemini API شروع سریع

این شروع سریع به شما نشان می دهد که چگونه با استفاده از SDK انتخابی خود با Gemini API شروع کنید.

Python Node.js Go Dart (Flutter) Android Swift Web REST

پیش نیازها

این شروع سریع فرض می کند که شما با استفاده از Android Studio برای توسعه برنامه های Android آشنا هستید.

برای تکمیل این شروع سریع، مطمئن شوید که محیط توسعه و برنامه Android شما شرایط زیر را دارد:

• اندروید استودیو (آخرین نسخه)
• برنامه Android شما باید سطح API 21 یا بالاتر را هدف قرار دهد.

دسترسی Gemini روی دستگاه را در نظر بگیرید

سرویس گیرنده SDK برای Android که در این آموزش توضیح داده شده است به شما امکان می دهد به مدل های Gemini که در سرورهای Google اجرا می شوند دسترسی داشته باشید. برای موارد استفاده‌ای که شامل پردازش داده‌های حساس، در دسترس بودن آفلاین، یا صرفه‌جویی در هزینه برای جریان‌های کاربر اغلب استفاده می‌شود، ممکن است بخواهید به Gemini Nano که روی دستگاه اجرا می‌شود دسترسی داشته باشید. برای جزئیات بیشتر، به صفحه Android (روی دستگاه) مراجعه کنید.

Gemini API SDK را نصب کنید

1. در فایل پیکربندی Gradle ماژول (سطح برنامه) خود (مانند <project>/<app-module>/build.gradle.kts )، وابستگی را برای Google AI SDK برای Android اضافه کنید:

   کاتلین

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

   جاوا

   برای جاوا، باید دو کتابخانه اضافی اضافه کنید.

   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. پروژه اندروید خود را با فایل های Gradle همگام سازی کنید.

احراز هویت را تنظیم کنید

ساده ترین راه برای احراز هویت در Gemini API پیکربندی یک کلید API است، همانطور که در این بخش توضیح داده شده است. اگر به کنترل‌های دسترسی سخت‌تر نیاز دارید، می‌توانید به جای آن از OAuth استفاده کنید .

اگر از قبل یک کلید API ندارید، در Google AI Studio ایجاد کنید.

یک کلید API از Google AI Studio دریافت کنید

سپس، کلید خود را پیکربندی کنید.

اکیداً توصیه می شود که یک کلید API را در سیستم کنترل نسخه خود بررسی نکنید . در عوض، باید آن را در یک فایل local.properties (که در فهرست اصلی پروژه شما قرار دارد، اما از کنترل نسخه حذف شده است) ذخیره کنید و سپس از افزونه Secrets Gradle برای اندروید برای خواندن کلید API خود به عنوان یک متغیر Build Configuration استفاده کنید.

// 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 Generative را وارد کنید.

// 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، به راهنمای زیر مراجعه کنید:

• تولید متن
• چشم انداز
• صوتی
• زمینه طولانی

برای مستندات عمیق روش‌های API Gemini و پارامترهای درخواست، به راهنماهای موجود در مرجع API مراجعه کنید.