Tài liệu tham khảo về Gemini API

Tài liệu tham khảo API này mô tả các API đơn phương, truyền trực tuyến và theo thời gian thực mà bạn có thể dùng để tương tác với các mô hình Gemini. Bạn có thể sử dụng các API REST trong mọi môi trường hỗ trợ yêu cầu HTTP. Hãy tham khảo Hướng dẫn bắt đầu sử dụng để biết cách bắt đầu với lệnh gọi API đầu tiên. Nếu bạn đang tìm tài liệu tham khảo cho các thư viện và SDK dành riêng cho ngôn ngữ của chúng tôi, hãy chuyển đến đường liên kết cho ngôn ngữ đó trong bảng điều hướng bên trái, trong mục Tài liệu tham khảo về SDK.

Điểm cuối chính

Gemini API được sắp xếp theo các điểm cuối chính sau đây:

• Tương tác (CreateInteraction) (Đề xuất): Nguyên tắc cơ bản tiêu chuẩn được đề xuất để xây dựng bằng Gemini, được tối ưu hoá cho quy trình công việc dựa trên tác nhân, quản lý trạng thái phía máy chủ và các cuộc trò chuyện phức tạp nhiều lượt ở nhiều chế độ.
• Tạo nội dung tiêu chuẩn (generateContent): Một điểm cuối REST tiêu chuẩn xử lý yêu cầu của bạn và trả về toàn bộ phản hồi của mô hình trong một gói duy nhất. Cách này phù hợp nhất với các tác vụ không tương tác mà bạn có thể chờ toàn bộ kết quả.
• Tạo nội dung phát trực tiếp (streamGenerateContent): Sử dụng Sự kiện do máy chủ gửi (SSE) để gửi các đoạn phản hồi cho bạn khi chúng được tạo. Điều này mang đến trải nghiệm nhanh hơn và giàu tính tương tác hơn cho các ứng dụng như chatbot.
• Live API (BidiGenerateContent): Một API dựa trên WebSocket có trạng thái để truyền phát trực tiếp hai chiều, được thiết kế cho các trường hợp sử dụng đàm thoại theo thời gian thực.
• Chế độ hàng loạt (batchGenerateContent): Một điểm cuối REST tiêu chuẩn để gửi hàng loạt yêu cầu generateContent.
• Nhúng (embedContent): Một điểm cuối REST tiêu chuẩn tạo ra vectơ nhúng văn bản từ Content đầu vào.
• Gen Media API: Điểm cuối để tạo nội dung nghe nhìn bằng các mô hình chuyên biệt của chúng tôi, chẳng hạn như Imagen để tạo hình ảnh và Veo để tạo video. Gemini cũng có sẵn những chức năng này mà bạn có thể truy cập bằng generateContent API.
• API nền tảng: Các điểm cuối tiện ích hỗ trợ các chức năng cốt lõi như tải tệp lên và đếm mã thông báo.

Xác thực

Tất cả các yêu cầu gửi đến Gemini API đều phải có tiêu đề x-goog-api-key kèm theo khoá API của bạn. Tạo một câu lệnh chỉ bằng vài cú nhấp chuột trong Google AI Studio.

Sau đây là một yêu cầu mẫu có khoá API trong tiêu đề:

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"
          }
        ]
      }
    ]
  }'

Để biết hướng dẫn về cách truyền khoá đến API bằng Gemini SDK, hãy xem hướng dẫn Sử dụng khoá Gemini API.