Hướng dẫn nhanh về Gemini API

Hướng dẫn nhanh này cho bạn biết cách cài đặt các thư viện của chúng tôi và thực hiện yêu cầu API đầu tiên đối với Gemini API bằng Interactions API.

Trước khi bắt đầu

Để sử dụng Gemini API, bạn cần có một khoá API để xác thực các yêu cầu, thực thi giới hạn bảo mật và theo dõi mức sử dụng cho tài khoản của bạn.

Tạo một dự án trên AI Studio miễn phí để bắt đầu:

Tạo khoá Gemini API

Cài đặt Google GenAI SDK

pip install -q -U google-genai

npm install @google/genai

Tạo yêu cầu đầu tiên

Bạn có thể dùng 2 cách để gửi yêu cầu đến Gemini API:

• (Nên dùng) Interactions API là một nguyên tắc cơ bản mới có hỗ trợ gốc cho việc sử dụng công cụ nhiều bước, điều phối và các luồng suy luận phức tạp thông qua các bước thực thi được nhập. Trong tương lai, các mô hình mới ngoài dòng sản phẩm cốt lõi, cùng với các công cụ và khả năng của tác nhân AI mới, sẽ chỉ ra mắt trên Interactions API.
• generateContent cung cấp một cách để tạo câu trả lời đơn giản, không có trạng thái từ một mô hình. Mặc dù bạn nên sử dụng Interactions API, nhưng generateContent vẫn được hỗ trợ đầy đủ.

Ví dụ này sử dụng Interactions API để gửi yêu cầu đến Gemini API bằng mô hình Gemini 3 Flash.

Nếu bạn đặt khoá API làm biến môi trường GEMINI_API_KEY, thì ứng dụng sẽ tự động chọn khoá này khi sử dụng Thư viện Gemini API. Nếu không, bạn sẽ cần truyền khoá API làm đối số khi khởi chạy ứng dụng.

Xin lưu ý rằng tất cả các mẫu mã trong tài liệu về Gemini API đều giả định rằng bạn đã đặt biến môi trường GEMINI_API_KEY.

# This will only work for SDK newer than 2.0.0
from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

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

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

// This will only work for SDK newer than 2.0.0
import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

# Specifies the API revision to avoid breaking changes when they become default
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Api-Revision: 2026-05-20" \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Chế độ không trạng thái

Theo mặc định, Interactions API quản lý trạng thái cuộc trò chuyện phía máy chủ khi bạn sử dụng previous_interaction_id. Nếu muốn tự quản lý nhật ký cuộc trò chuyện ở phía máy khách, bạn có thể chọn sử dụng chế độ không trạng thái bằng cách đặt store=false và truyền các bước đã tích luỹ trong trường input của các yêu cầu tiếp theo.

Để biết thông tin chi tiết và ví dụ đầy đủ về trạng thái không có trạng thái nhiều lượt, hãy xem Hướng dẫn tạo văn bản.

Bước tiếp theo

Giờ đây, khi đã thực hiện yêu cầu API đầu tiên, bạn có thể muốn khám phá các hướng dẫn sau đây cho thấy Gemini đang hoạt động:

• Tạo văn bản
• Tạo hình ảnh
• Hiểu hình ảnh
• Tư duy
• Gọi hàm
• Ngữ cảnh dài
• Vectơ nhúng