การเริ่มต้นใช้งาน Gemini API อย่างรวดเร็ว

การเริ่มต้นใช้งานฉบับย่อนี้จะแสดงวิธีเริ่มต้นใช้งาน Gemini API โดยใช้ SDK ที่คุณเลือก

Python Node.js Go Dart (Flutter) Android Swift เว็บ REST

ข้อกำหนดเบื้องต้น

การเริ่มต้นใช้งานฉบับย่อนี้ถือว่าคุณคุ้นเคยกับการใช้ Android Studio ในการพัฒนาแอป Android

โปรดตรวจสอบว่าสภาพแวดล้อมการพัฒนาและแอป Android ของคุณเป็นไปตามข้อกำหนดต่อไปนี้เพื่อให้การเริ่มต้นใช้งานนี้เสร็จสมบูรณ์

• Android Studio (เวอร์ชันล่าสุด)
• แอป Android ของคุณต้องกำหนดเป้าหมายเป็น API ระดับ 21 ขึ้นไป

ลองเข้าถึง Gemini บนอุปกรณ์

SDK ของไคลเอ็นต์สําหรับ Android ที่อธิบายในบทแนะนํานี้จะช่วยให้คุณเข้าถึงโมเดล Gemini ซึ่งทํางานบนเซิร์ฟเวอร์ของ Google ได้ สําหรับกรณีการใช้งานที่เกี่ยวข้องกับการประมวลผลข้อมูลที่ละเอียดอ่อน ความพร้อมใช้งานแบบออฟไลน์ หรือเพื่อประหยัดค่าใช้จ่ายสำหรับขั้นตอนที่ผู้ใช้ใช้บ่อย คุณอาจต้องพิจารณาเข้าถึง Gemini Nano ซึ่งทํางานบนอุปกรณ์ ดูรายละเอียดเพิ่มเติมได้ที่หน้า Android (ในอุปกรณ์)

ติดตั้ง Gemini API SDK

1. ในไฟล์การกําหนดค่า Gradle ของโมดูล (ระดับแอป) (เช่น <project>/<app-module>/build.gradle.kts) ให้เพิ่มทรัพยากร Dependency สําหรับ Google AI SDK สําหรับ 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 คุณต้องเพิ่มไลบรารีอีก 2 รายการ

   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 คือการกำหนดค่าคีย์ API ตามที่อธิบายไว้ในส่วนนี้ หากต้องการการควบคุมการเข้าถึงที่เข้มงวดยิ่งขึ้น คุณใช้ OAuth แทนได้

หากยังไม่มีคีย์ API ให้สร้างคีย์ใน Google AI Studio

รับคีย์ API จาก Google AI Studio

จากนั้นจึงกำหนดค่าคีย์

เราขอแนะนำอย่างยิ่งว่าอย่าตรวจสอบคีย์ API ในระบบควบคุมเวอร์ชัน แต่ควรจัดเก็บไว้ในlocal.propertiesไฟล์ (ซึ่งอยู่ในไดเรกทอรีรูทของโปรเจ็กต์ แต่ยกเว้นจากการควบคุมเวอร์ชัน) จากนั้นใช้ปลั๊กอิน Gradle สำหรับ Android เพื่ออ่านคีย์ API เป็นตัวแปรการกำหนดค่าบิลด์

// 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 เพื่อช่วยคุณเริ่มต้นใช้งาน)

นําเข้าคลัง

นําเข้าคลัง Generative AI ของ 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 ได้ที่คำแนะนำในเอกสารอ้างอิง API