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

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

ปลายทางหลัก

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

• การโต้ตอบ (CreateInteraction) (แนะนำ): Primitive มาตรฐานที่แนะนำสำหรับการสร้างด้วย Gemini ซึ่งได้รับการปรับให้เหมาะกับ เวิร์กโฟลว์แบบ Agentic, การจัดการสถานะฝั่งเซิร์ฟเวอร์ และการสนทนาที่ซับซ้อนแบบหลายโมดัล และการสนทนาไปมา
• การสร้างเนื้อหามาตรฐาน (generateContent): ปลายทาง REST มาตรฐานที่ประมวลผลคำขอและแสดงผลลัพธ์ทั้งหมดของโมเดลในแพ็กเกจเดียว เหมาะที่สุดสำหรับงานที่ไม่โต้ตอบซึ่งคุณรอผลลัพธ์ทั้งหมดได้
• การสร้างเนื้อหาแบบสตรีมมิง (streamGenerateContent): ใช้เหตุการณ์ที่เซิร์ฟเวอร์ส่ง (Server-Sent Events หรือ SSE) เพื่อส่งข้อมูลคำตอบเป็น Chunk ให้คุณเมื่อมีการสร้าง ซึ่งจะมอบประสบการณ์การใช้งานที่รวดเร็วและโต้ตอบได้มากขึ้นสำหรับแอปพลิเคชันอย่างแชทบ็อต
• Live API (BidiGenerateContent): API ที่อิงตาม WebSocket แบบ Stateful สำหรับสตรีมมิงแบบสองทิศทาง ซึ่งออกแบบมาสำหรับกรณีการใช้งานการสนทนาแบบเรียลไทม์
• โหมดแบตช์ (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