ไลบรารี Gemini API

เมื่อสร้างด้วย Gemini API เราขอแนะนำให้ใช้ Google GenAI SDK ซึ่งเป็นไลบรารีอย่างเป็นทางการที่พร้อมใช้งานจริงที่เราพัฒนาและดูแลรักษา สำหรับภาษายอดนิยม โดยจะอยู่ในความพร้อมใช้งานทั่วไปและใช้ในเอกสารและตัวอย่างอย่างเป็นทางการทั้งหมดของเรา

หากเพิ่งเริ่มใช้ Gemini API โปรดทำตามคู่มือเริ่มใช้งานฉบับย่อเพื่อเริ่มต้นใช้งาน

การรองรับภาษาและการติดตั้ง

Google GenAI SDK พร้อมใช้งานสำหรับภาษา Python, JavaScript/TypeScript, Go และ Java คุณติดตั้งไลบรารีของแต่ละภาษาได้โดยใช้เครื่องมือจัดการแพ็กเกจ หรือไปที่ที่เก็บ GitHub ของภาษาเหล่านั้นเพื่อดูข้อมูลเพิ่มเติม

Python

คลัง: google-genai
ที่เก็บ GitHub: googleapis/python-genai
การติดตั้ง: pip install google-genai

JavaScript

คลัง: @google/genai
ที่เก็บ GitHub: googleapis/js-genai
การติดตั้ง: npm install @google/genai

Go

คลัง: google.golang.org/genai
ที่เก็บ GitHub: googleapis/go-genai
การติดตั้ง: go get google.golang.org/genai

Java

คลัง: google-genai
ที่เก็บ GitHub: googleapis/java-genai
การติดตั้ง: หากคุณใช้ Maven ให้เพิ่มข้อมูลต่อไปนี้ลงในทรัพยากร Dependency

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

C#

คลัง: Google.GenAI
ที่เก็บใน GitHub: googleapis/dotnet-genai
การติดตั้ง: dotnet add package Google.GenAI

สำหรับผู้ใช้ทั่วไป

เราได้เริ่มเปิดตัว Google GenAI SDK ซึ่งเป็นชุดไลบรารีใหม่สำหรับเข้าถึง Gemini API ในช่วงปลายปี 2024 เมื่อเปิดตัว Gemini 2.0

ตั้งแต่เดือนพฤษภาคม 2025 เป็นต้นไป ไลบรารีเหล่านี้จะพร้อมให้บริการแก่ผู้ใช้ทั่วไป (GA) ในแพลตฟอร์มที่รองรับทั้งหมด และเป็นไลบรารีที่แนะนำสำหรับการเข้าถึง Gemini API โดยเป็นเวอร์ชัน เสถียร รองรับการใช้งานจริงอย่างเต็มรูปแบบ และได้รับการบำรุงรักษาอย่างต่อเนื่อง โดยจะให้สิทธิ์เข้าถึงฟีเจอร์ล่าสุดและมอบประสิทธิภาพที่ดีที่สุดเมื่อทำงานร่วมกับ Gemini

หากคุณใช้ไลบรารีเดิมของเรา เราขอแนะนำอย่างยิ่งให้คุณย้ายข้อมูลเพื่อให้เข้าถึงฟีเจอร์ล่าสุดและ ได้รับประสิทธิภาพที่ดีที่สุดเมื่อทำงานกับ Gemini ดูข้อมูลเพิ่มเติมได้ที่ส่วนไลบรารีเดิม

ไลบรารีเดิมและการย้ายข้อมูล

หากคุณใช้ไลบรารีเดิมของเรา เราขอแนะนำให้ย้ายข้อมูลไปยังไลบรารีใหม่

ไลบรารีเวอร์ชันเดิมไม่ให้สิทธิ์เข้าถึงฟีเจอร์ล่าสุด (เช่น Live API และ Veo) และกำลังจะเลิกใช้งาน โดยจะหยุดรับการอัปเดตในวันที่ 30 พฤศจิกายน 2025 ช่องว่างของฟีเจอร์จะเพิ่มขึ้นและอาจไม่มีการแก้ไขข้อบกพร่องที่อาจเกิดขึ้นอีกต่อไป

สถานะการสนับสนุนของคลังข้อมูลเดิมแต่ละแห่งจะแตกต่างกัน โดยมีรายละเอียดในตารางต่อไปนี้

ภาษา	คลังเดิม	สถานะการรองรับ	คลังที่แนะนำ
Python	`google-generativeai`	การสนับสนุนทั้งหมด รวมถึงการแก้ไขข้อบกพร่อง จะสิ้นสุดในวันที่ 30 พฤศจิกายน 2025	`google-genai`
JavaScript/TypeScript	`@google/generativeai`	การสนับสนุนทั้งหมด รวมถึงการแก้ไขข้อบกพร่อง จะสิ้นสุดในวันที่ 30 พฤศจิกายน 2025	`@google/genai`
Go	`google.golang.org/generative-ai`	การสนับสนุนทั้งหมด รวมถึงการแก้ไขข้อบกพร่อง จะสิ้นสุดในวันที่ 30 พฤศจิกายน 2025	`google.golang.org/genai`
Dart และ Flutter	`google_generative_ai`	ไม่ได้ดูแลอย่างสม่ำเสมอ	ใช้ไลบรารีของชุมชนหรือบุคคลที่สามที่เชื่อถือได้ เช่น firebase_ai หรือเข้าถึงโดยใช้ REST API
Swift	`generative-ai-swift`	ไม่ได้ดูแลอย่างสม่ำเสมอ	ใช้ Firebase AI Logic
Android	`generative-ai-android`	ไม่ได้ดูแลอย่างสม่ำเสมอ	ใช้ Firebase AI Logic

หมายเหตุสำหรับนักพัฒนาซอฟต์แวร์ Java: ไม่มี Java SDK แบบเดิมที่ Google จัดเตรียมไว้สำหรับ Gemini API จึงไม่จำเป็นต้องย้ายข้อมูลจากไลบรารีของ Google ก่อนหน้านี้ คุณ สามารถเริ่มต้นใช้งานไลบรารีใหม่ได้โดยตรงในส่วนการรองรับภาษาและการติดตั้ง

เทมเพลตพรอมต์สำหรับการสร้างโค้ด

โมเดล Generative (เช่น Gemini, Claude) และ IDE ที่ทำงานด้วยระบบ AI (เช่น Cursor) อาจสร้างโค้ดสำหรับ Gemini API โดยใช้ไลบรารีที่ล้าสมัยหรือเลิกใช้งานแล้วเนื่องจาก ข้อมูลการฝึกของโมเดลดังกล่าวมีวันหมดอายุ หากต้องการให้โค้ดที่สร้างขึ้นใช้ไลบรารีเวอร์ชันล่าสุดที่แนะนำ ให้ระบุคำแนะนำเกี่ยวกับเวอร์ชันและการใช้งานในพรอมต์โดยตรง คุณใช้เทมเพลตด้านล่างเพื่อระบุบริบทที่จำเป็นได้