เอกสารอ้างอิง 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