Hướng Dẫn Sử Dụng API Gemini 3.0

Ashley Innocent

Ashley Innocent

18 tháng 11 2025

Hướng Dẫn Sử Dụng API Gemini 3.0

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Các nhà phát triển luôn tìm kiếm các mô hình AI mạnh mẽ mà không phải chịu chi phí cao. Google giải quyết nhu cầu này bằng cách cung cấp quyền truy cập miễn phí vào các mô hình tiên tiến, bao gồm các phiên bản xem trước như Gemini 3 Pro.

💡
Trước khi tiếp tục, hãy tải xuống Apidog miễn phí ngay bây giờ – nó đóng vai trò là một ứng dụng khách API tuyệt vời để gửi yêu cầu đến Gemini 3 API, kiểm tra phản hồi, xử lý đầu vào đa phương thức và gỡ lỗi các điểm cuối một cách hiệu quả trong quá trình thử nghiệm cấp miễn phí của bạn.
nút

Google duy trì một bậc miễn phí hào phóng cho Gemini API thông qua Google AI Studio. Cấu hình này cho phép bạn tạo khóa API và bắt đầu gọi các mô hình ngay lập tức. Hơn nữa, kể từ tháng 11 năm 2025, Google cung cấp quyền truy cập vào các mô hình xem trước Gemini 3 Pro miễn phí, mặc dù có giới hạn tốc độ phù hợp cho việc tạo mẫu, thử nghiệm và các ứng dụng quy mô nhỏ.

Tìm hiểu về Giá Gemini 3 API

Thông thường, giá của Gemini 3.0 như sau:

Ngày cắt giảm kiến thức của Gemini 3.0 được đặt là tháng 1 năm 2025.

Nếu bạn muốn sử dụng Gemini 3.0 API miễn phí, Google đủ hào phóng để cho phép bạn dùng thử: Google cấu trúc Gemini API xoay quanh hai bậc chính: miễn phí và trả tiền theo mức sử dụng. Bậc miễn phí hoạt động hoàn toàn mà không cần kích hoạt thanh toán. Do đó, tất cả các yêu cầu vẫn miễn phí cho đến khi bạn bật rõ ràng Thanh toán trên Cloud để có hạn ngạch cao hơn.

Google AI Studio hoạt động như giao diện chính để truy cập miễn phí. Tại đây, bạn tạo mẫu các lời nhắc, tạo khóa API và gọi trực tiếp các mô hình. Các mô hình xem trước như Gemini 3 Pro tự động xuất hiện trong bộ chọn mô hình khi có sẵn trong khu vực của bạn.

Các lợi ích chính của bậc miễn phí bao gồm:

Tuy nhiên, bậc miễn phí áp dụng hạn ngạch để đảm bảo sử dụng công bằng. Giới hạn điển hình cho các mô hình xem trước Gemini 3 Pro là khoảng 5-10 yêu cầu mỗi phút (RPM), 250.000 token mỗi phút (TPM) và 50-100 yêu cầu mỗi ngày (RPD). Các giá trị này thay đổi tùy theo biến thể mô hình và khu vực, và Google điều chỉnh chúng định kỳ.

Từng bước: Tạo Khóa API Gemini 3 của Bạn

Bạn bắt đầu bằng cách tạo khóa API trong Google AI Studio. Thực hiện theo các bước chính xác sau:

  1. Điều hướng đến aistudio.google.com.
  2. Đăng nhập bằng tài khoản Google của bạn (cá nhân hoặc Workspace).

4. Nhấp vào biểu tượng hồ sơ ở góc trên bên phải và chọn "Get API key" (Lấy khóa API). Chọn "Create API key in new project" (Tạo khóa API trong dự án mới) (hoặc chọn một dự án hiện có).

6. Google tạo khóa ngay lập tức. Sao chép nó ngay lập tức – bạn không thể xem lại nó.

Hơn nữa, bạn có thể tạo nhiều khóa và giới hạn chúng cho các người giới thiệu hoặc địa chỉ IP cụ thể để bảo mật. Luôn coi khóa là dữ liệu nhạy cảm; không bao giờ đưa nó lên các kho lưu trữ công khai.

Để truy cập trực tiếp bản xem trước Gemini 3 Pro, hãy truy cập liên kết này do Google cung cấp: https://aistudio.google.com/prompts/new_chat?model=gemini-3-pro-preview. Điều này sẽ mở một giao diện trò chuyện được cấu hình sẵn với mô hình xem trước.

Hãy thử Gemini 3.0 API trong Google AI Studio

Cài đặt các SDK Gemini chính thức để truy cập theo chương trình

Google cung cấp các thư viện máy khách bằng nhiều ngôn ngữ. Bạn cài đặt chúng thông qua các trình quản lý gói.

Đối với các nhà phát triển Python:

pip install -U google-generativeai

Sau đó cấu hình thư viện:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY_HERE")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content("Giải thích vướng víu lượng tử bằng các thuật ngữ đơn giản.")
print(response.text)

Người dùng Node.js chạy:

npm install @google/generative-ai
const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY_HERE");
const model = genAI.getGenerativeModel({ model: "gemini-3-pro-preview-11-2025" });

const result = await model.generateContent("Viết một hàm Python để tính số Fibonacci.");
console.log(result.response.text());

Các ngôn ngữ được hỗ trợ khác bao gồm Go, Java và Swift. Tất cả các thư viện đều xử lý xác thực, thử lại và truyền trực tuyến một cách tự động.

Gửi Yêu cầu đầu tiên của bạn đến Gemini 3 API bằng curl

Bạn có thể kiểm tra trực tiếp bằng curl để xác minh nhanh:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-preview-11-2025:generateContent?key=YOUR_API_KEY \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "Mô tả những cải tiến chính trong Gemini 3 so với các phiên bản trước." }]
    }]
  }'

Điểm cuối này trả về phản hồi JSON chứa văn bản được tạo và siêu dữ liệu sử dụng.

Sử dụng Apidog để có Quy trình làm việc kiểm thử API tốt hơn, tích hợp hơn

Các lệnh curl thô hoạt động cho các thử nghiệm đơn giản, nhưng phát triển cấp sản xuất đòi hỏi các công cụ tốt hơn. Apidog vượt trội ở đây như một ứng dụng khách API đầy đủ tính năng và nền tảng tài liệu.

nút

Bạn nhập đặc tả OpenAPI chính thức của Gemini vào Apidog, công cụ này tự động tạo tất cả các điểm cuối, tham số và nội dung yêu cầu. Sau đó, bạn:

Giao diện của Apidog để kiểm thử các điểm cuối Gemini 3 API

Nhiều nhà phát triển chọn Apidog đặc biệt cho các quy trình làm việc của Gemini vì nó xử lý việc tải lên tệp lớn, phản hồi luồng và đầu ra JSON có cấu trúc một cách liền mạch – những tính năng mà Postman gặp khó khăn với các API tạo sinh.

Giới hạn Tốc độ của Gemini 3.0 API là gì?

Google hiện không tiết lộ giới hạn tốc độ của Gemini 3.0 API, mặc dù người dùng đang báo cáo rằng họ đang gặp phải giới hạn tốc độ trong vòng vài cuộc trò chuyện (Mã lỗi: Bạn đã đạt đến giới hạn tốc độ của mình. Vui lòng thử lại sau.)

Dựa trên tài liệu chính thức của Google, Gemini API có một bậc miễn phí có thể truy cập qua Google AI Studio và tuân theo các giới hạn tốc độ để đảm bảo sử dụng công bằng. Các giới hạn này chủ yếu được đo bằng Yêu cầu mỗi phút (RPM), và đối với một số mô hình, còn có Yêu cầu mỗi ngày (RPD)Token mỗi phút (TPM). Ví dụ, mô hình tiêu chuẩn gemini-1.0-pro có giới hạn tốc độ miễn phí là 60 RPM, thường đủ cho việc phát triển và thử nghiệm. Các giới hạn này được cung cấp miễn phí và không yêu cầu thiết lập tài khoản thanh toán.

Các mô hình khác nhau trong họ Gemini có giới hạn tốc độ khác nhau. Vượt quá giới hạn tốc độ của một mô hình sẽ dẫn đến lỗi HTTP 429 "Resource Exhausted" (Tài nguyên cạn kiệt). Để quản lý điều này, các nhà phát triển nên triển khai xử lý lỗi với chiến lược lùi lại theo cấp số nhân, bao gồm việc chờ đợi trong khoảng thời gian dài hơn dần dần trước khi thử lại một yêu cầu. Đối với các ứng dụng yêu cầu khối lượng yêu cầu cao hơn bậc miễn phí cho phép, bạn phải bật thanh toán trên một dự án Google Cloud và chuyển sang gói trả tiền theo mức sử dụng, gói này cung cấp giới hạn cao hơn đáng kể (ai.google.dev).

Để có thông lượng cao hơn, bạn tạo nhiều tài khoản Google (mỗi tài khoản có khóa riêng) và xoay vòng chúng – một thực hành phổ biến của các nhà phát triển để duy trì trong giới hạn miễn phí.

Thị giác và Video với Gemini 3.0 API

Gemini 3 xử lý hình ảnh và video nguyên bản. Ví dụ mã Python để phân tích hình ảnh:

from google.generativeai.types import File

image_file = genai.upload_file(path="diagram.png")

model = genai.GenerativeModel("gemini-3-pro-preview-11-2025")
response = model.generate_content([
    "Giải thích chi tiết sơ đồ kiến trúc này:",
    image_file
])
print(response.text)

Hiểu video hoạt động tương tự – tải lên một tệp MP4 và đặt câu hỏi về nội dung, dấu thời gian hoặc hành động.

Kết luận

Google cho phép truy cập chưa từng có vào AI cấp tiên tiến thông qua bậc miễn phí của mình. Bạn có thể nhận khóa trong vòng chưa đầy hai phút, bắt đầu gọi các mô hình xem trước Gemini 3 Pro ngay lập tức và xây dựng các ứng dụng phức tạp mà không tốn tiền.

Kết hợp khả năng này với một ứng dụng khách API mạnh mẽ như Apidog, và bạn có được một môi trường phát triển hoàn chỉnh sánh ngang với các dịch vụ trả phí. Hàng ngàn nhà phát triển đã tạo mẫu các tác nhân, hệ thống RAG và ứng dụng đa phương thức theo cách này.

Hãy hành động ngay: truy cập Google AI Studio, tạo khóa của bạn, tải xuống Apidog và gửi yêu cầu Gemini 3 đầu tiên của bạn. Rào cản để xây dựng với AI tiên tiến chưa bao giờ thấp hơn thế.

nút

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API