Tài liệu tham khảo API này mô tả các API đơn biến, truyền dữ liệu và thời gian thực mà bạn có thể sử dụng để tương tác với các mô hình Gemini. Bạn có thể sử dụng API REST trong bất kỳ môi trường nào hỗ trợ yêu cầu HTTP. Hãy tham khảo Hướng dẫn bắt đầu để biết cách bắt đầu với cuộc gọi API đầu tiên của bạn. Nếu bạn đang tìm kiếm tài liệu tham khảo cho các thư viện và SDK dành riêng cho từng ngôn ngữ của chúng tôi, hãy truy cập vào liên kết dành cho ngôn ngữ đó trong thanh điều hướng bên trái dưới mục Tài liệu tham khảo SDK.
Điểm cuối chính
API của Gemini được tổ chức xung quanh các điểm cuối chính sau:
- Tương tác (
CreateInteraction) (Khuyến khích): Đây là cấu trúc cơ bản tiêu chuẩn được khuyến nghị để xây dựng với Gemini, được tối ưu hóa cho quy trình làm 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 hội thoại đa phương thức, đa lượt phức tạp. - 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. Phương pháp này phù hợp nhất cho các tác vụ không cần tương tác, nơi bạn có thể chờ đợi toàn bộ kết quả. - Tạo nội dung phát trực tuyến (
streamGenerateContent): Sử dụng Server-Sent Events (SSE) để gửi từng phần phản hồi cho bạn ngay khi chúng được tạo ra. Điều này mang lại trải nghiệm nhanh hơn và tương tác tốt hơn cho các ứng dụng như chatbot. - API trực tiếp (
BidiGenerateContent): Một API dựa trên WebSocket có trạng thái, dùng cho truyền phát hai chiều, được thiết kế cho các trường hợp sử dụng hội thoại 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 cácgenerateContentyêu cầu. - Các phép 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ừ dữ liệu đầu vào.Content. - API Gen Media: Các điểm cuối để tạo phương tiện với các mô hình chuyên dụng của chúng tôi như Imagen để tạo hình ảnh và Veo để tạo video.
Gemini cũng tích hợp sẵn các khả năng này mà bạn có thể truy cập bằng API
generateContent. - API nền tảng: Các điểm cuối tiện ích hỗ trợ các khả năng cốt lõi như tải lên tập tin và đếm mã thông báo.
Xác thực
Tất cả các yêu cầu gửi đến API Gemini phải bao gồm tiêu đề x-goog-api-key với khóa API của bạn. Tạo một cái chỉ với vài cú nhấp chuột trong Google AI Studio.
Dưới đây là một ví dụ về yêu cầu có chứa khóa API trong phần tiêu đề:
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.8-flash",
"input": "Explain how AI works in a few words"
}'
Để biết hướng dẫn về cách chuyển khóa của bạn cho API bằng cách sử dụng Gemini SDK, hãy xem hướng dẫn Sử dụng khóa API Gemini.