การเริ่มต้นใช้งาน

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

Interactions API พร้อมใช้งานผ่าน SDK ของ Python และ JavaScript รวมถึงผ่าน REST

1. รับคีย์ API

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

• Google AI Studio จะสร้างโปรเจ็กต์และคีย์ API ให้กับผู้ใช้ใหม่โดยอัตโนมัติ คุณคัดลอกได้จากหน้าคีย์ API
• หากต้องการคีย์ใหม่ ให้คลิกสร้างคีย์ API ใน AI Studio แล้วทำตาม กล่องโต้ตอบเพื่อเพิ่มคู่คีย์-โปรเจ็กต์ใหม่

สร้างคีย์ Gemini API

ตั้งค่าคีย์เป็นตัวแปรสภาพแวดล้อม

export GEMINI_API_KEY="YOUR_API_KEY"

อัปเกรดเป็นระดับแบบชำระเงิน

การอัปเกรดเป็นระดับแบบชำระเงินจะเพิ่มการจำกัดอัตราคำขอและต้องตั้งค่าการเรียกเก็บเงินใน Cloud

• คลิกตั้งค่าการเรียกเก็บเงินในหน้าคีย์ API หรือโปรเจ็กต์ของ AI Studio
• ทำตามกล่องโต้ตอบการเรียกเก็บเงินใน Cloud เพื่อสร้างหรือลิงก์บัญชีสำหรับการเรียกเก็บเงิน เพิ่มวิธีการชำระเงิน และชำระล่วงหน้าอย่างน้อย $10 (หรือเทียบเท่าในสกุลเงินอื่น) ในเครดิตที่ชำระเงินแล้ว
• ดูการใช้งาน API ใน Google AI Studio ในส่วนแดชบอร์ด > การใช้งาน

ดูข้อมูลเพิ่มเติมได้ที่หน้าการเรียกเก็บเงิน

2. ติดตั้ง SDK และทำการเรียกครั้งแรก

ติดตั้ง SDK และสร้างข้อความด้วยการเรียก API เพียงครั้งเดียว

pip install -U google-genai

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.6-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

npm install @google/genai

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.6-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Explain how AI works in a few words"
  }'

คำตอบ:

{
  "id": "v1_ChdpQUFvYXI...",
  "status": "completed",
  "usage": {
    "total_tokens": 197,
    "total_input_tokens": 8,
    "total_output_tokens": 12
  },
  "created": "2026-06-09T12:01:25Z",
  "steps": [
    {
      "type": "thought",
      "signature": "EvEFCu4FAQw..."
    },
    {
      "type": "model_output",
      "content": [
        {
          "type": "text",
          "text": "AI learns patterns from data, then uses those patterns to make predictions or decisions on new data."
        }
      ]
    }
  ],
  "object": "interaction",
  "model": "gemini-3.6-flash",
}

เมื่อใช้ REST API จะแสดงInteractionแบบเต็มซึ่งมีข้อมูลเมตา สถิติการใช้งาน และประวัติแบบทีละขั้นตอนของคำพูด

แม้ว่า SDK จะแสดงการตอบกลับทั้งหมด แต่ก็ยังมีพร็อพเพอร์ตี้ที่สะดวก เช่น interaction.output_text และ interaction.output_image เพื่อเข้าถึงเอาต์พุตสุดท้ายได้โดยตรง ดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้างการตอบกลับได้ในภาพรวมของการโต้ตอบ หรืออ่านคู่มือการสร้างข้อความเพื่อดูรายละเอียดเกี่ยวกับวิธีการของระบบและการกำหนดค่าการสร้าง

3. สตรีมคำตอบ

สตรีมคำตอบขณะที่ระบบสร้างขึ้นเพื่อให้การโต้ตอบราบรื่นยิ่งขึ้น เหตุการณ์ step.delta แต่ละรายการจะส่งข้อความเป็นกลุ่มที่คุณแสดงได้ทันที

from google import genai

client = genai.Client()

stream = client.interactions.create(
    model="gemini-3.6-flash",
    input="Explain how AI works",
    stream=True
)
for event in stream:
    print(event)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const stream = await ai.interactions.create({
  model: "gemini-3.6-flash",
  input: "Explain how AI works",
  stream: true,
});

for await (const event