Bắt đầu

Hướng dẫn này giúp bạn bắt đầu sử dụng Gemini API bằng Interactions API. Bạn sẽ thực hiện lệnh gọi API đầu tiên trong vòng chưa đầy một phút và khám phá tính năng tạo văn bản, khả năng hiểu đa phương thức, tạo hình ảnh, đầu ra có cấu trúc, công cụ, gọi hàm, tác nhân và thực thi ở chế độ nền.

Bạn có thể sử dụng Interactions API thông qua SDK Python và JavaScript, cũng như thông qua REST.

1. Lấy khoá API

Để 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.

• Google AI Studio sẽ tự động tạo một dự án và khoá API cho người dùng mới. Bạn có thể sao chép khoá này từ trang khoá API.
• Nếu bạn cần một khoá mới, hãy nhấp vào Tạo khoá API trong AI Studio rồi làm theo hộp thoại để thêm một cặp khoá-dự án mới.

Tạo khoá Gemini API

Đặt khoá của bạn làm biến môi trường:

export GEMINI_API_KEY="YOUR_API_KEY"

Nâng cấp lên gói trả phí

Việc nâng cấp lên gói trả phí sẽ giúp bạn tăng hạn mức sử dụng và yêu cầu bạn thiết lập dịch vụ Thanh toán trên đám mây.

• Nhấp vào Thiết lập thông tin thanh toán trên trang Khoá API hoặc Dự án của AI Studio.
• Làm theo hộp thoại Thanh toán trên Cloud để tạo hoặc liên kết một tài khoản thanh toán, thêm một phương thức thanh toán và trả trước tối thiểu 10 USD (hoặc số tiền tương đương bằng đơn vị tiền tệ khác) dưới dạng tín dụng có tính phí.
• Xem mức sử dụng API trong Google AI Studio trong mục Trang tổng quan > Mức sử dụng.

Hãy xem trang Thanh toán để biết thêm thông tin.

2. Cài đặt SDK và thực hiện cuộc gọi đầu tiên

Cài đặt SDK và tạo văn bản bằng một lệnh gọi API duy nhất.

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