เอกสารอ้างอิง Gemini API

เอกสารอ้างอิง API นี้อธิบาย API แบบเอกภาค การสตรีม และแบบเรียลไทม์ที่คุณใช้โต้ตอบกับโมเดล Gemini ได้ คุณสามารถใช้ REST API ในทุกสภาพแวดล้อมที่รองรับคำขอ HTTP ดูวิธีเริ่มต้นใช้งานการเรียก API ครั้งแรกได้ที่ คู่มือเริ่มต้นใช้งาน หากต้องการดูเอกสารอ้างอิงสำหรับไลบรารีและ SDK เฉพาะภาษา ให้ไปที่ลิงก์ของภาษานั้นๆ ในการนำทางด้านซ้ายใต้เอกสารอ้างอิง SDK

ปลายทางหลัก

Gemini API จัดระเบียบตามปลายทางหลักต่อไปนี้

• การโต้ตอบ (CreateInteraction) (แนะนำ): องค์ประกอบพื้นฐานมาตรฐานที่แนะนำสำหรับการสร้างด้วย Gemini ซึ่งได้รับการปรับให้เหมาะกับ เวิร์กโฟลว์แบบ Agent การจัดการสถานะฝั่งเซิร์ฟเวอร์ และการสนทนาที่ซับซ้อนแบบหลายโมดัล การสนทนาไปมา
• การสร้างเนื้อหามาตรฐาน (generateContent): ปลายทาง REST มาตรฐานที่ประมวลผลคำขอและแสดงผลลัพธ์ทั้งหมดของโมเดลในแพ็กเกจเดียว เหมาะที่สุดสำหรับงานที่ไม่โต้ตอบซึ่งคุณรอผลลัพธ์ทั้งหมดได้
• การสร้างเนื้อหาแบบสตรีมมิง (streamGenerateContent): ใช้ Server-Sent Events (SSE) เพื่อส่งข้อมูลผลลัพธ์เป็นส่วนๆ ให้คุณเมื่อมีการสร้าง ซึ่งจะมอบประสบการณ์การใช้งานที่รวดเร็วและโต้ตอบได้มากขึ้นสำหรับแอปพลิเคชัน เช่น แชทบ็อต
• Live API (BidiGenerateContent): API ที่อิงตาม WebSocket แบบมีสถานะ สำหรับการสตรีมแบบสองทิศทาง ซึ่งออกแบบมาสำหรับกรณีการใช้งานการสนทนาแบบเรียลไทม์
• โหมดแบตช์ (batchGenerateContent): ปลายทาง REST มาตรฐานสำหรับการส่งคำขอ generateContent เป็นแบตช์
• การฝัง (embedContent): ปลายทาง REST มาตรฐาน ที่สร้างเวกเตอร์การฝังข้อความจาก Content อินพุต
• Gen Media API: ปลายทางสำหรับการสร้างสื่อด้วยโมเดลเฉพาะทางของเรา เช่น Imagen สำหรับการสร้างรูปภาพ และ Veo สำหรับการสร้างวิดีโอ นอกจากนี้ Gemini ยังมีความสามารถเหล่านี้ในตัว ซึ่งคุณเข้าถึงได้โดยใช้ generateContent API
• Platform API: ปลายทางยูทิลิตีที่รองรับความสามารถหลักๆ เช่น การอัปโหลดไฟล์ และ การนับโทเค็น

การตรวจสอบสิทธิ์

คำขอทั้งหมดที่ส่งไปยัง Gemini API จะต้องมีส่วนหัว x-goog-api-key พร้อมคีย์ API สร้างคีย์ API ได้ด้วยการคลิกเพียงไม่กี่ครั้งใน Google AI Studio

ตัวอย่างคำขอที่มีคีย์ API ในส่วนหัวมีดังนี้

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

ดูวิธีการส่งคีย์ไปยัง API โดยใช้ Gemini SDK ได้ที่ คู่มือการใช้คีย์ Gemini API