Models

Điểm cuối models cung cấp cho bạn cách liệt kê các mô hình hiện có theo phương thức lập trình và truy xuất siêu dữ liệu mở rộng, chẳng hạn như chức năng được hỗ trợ và kích thước cửa sổ theo bối cảnh. Đọc thêm trong hướng dẫn về Mô hình.

Phương thức: models.get

Lấy thông tin về một Model cụ thể, chẳng hạn như số phiên bản, hạn mức mã thông báo, tham số và siêu dữ liệu khác. Hãy tham khảo hướng dẫn về các mô hình Gemini để biết thông tin chi tiết về mô hình.

Điểm cuối

get https://generativelanguage.googleapis.com/v1beta/{name=models/*}

Tham số đường dẫn

name string

Bắt buộc. Tên tài nguyên của mô hình.

Tên này phải khớp với tên mô hình do phương thức models.list trả về.

Định dạng: models/{model}. Định dạng này có dạng models/{model}.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Ví dụ về yêu cầu

Python

from google import genai

client = genai.Client()
model_info = client.models.get(model="gemini-2.0-flash")
print(model_info)
models.py

Go

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}

modelInfo, err := client.Models.Get(ctx, "gemini-2.0-flash", nil)
if err != nil {
	log.Fatal(err)
}

fmt.Println(modelInfo)
models.go

Vỏ

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash?key=$GEMINI_API_KEY
models.sh

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Model.

Phương thức: models.list

Liệt kê Model có sẵn thông qua Gemini API.

Điểm cuối

get https://generativelanguage.googleapis.com/v1beta/models

Tham số truy vấn

pageSize integer

Số lượng Models tối đa cần trả về (trên mỗi trang).

Nếu không chỉ định, 50 mô hình sẽ được trả về trên mỗi trang. Phương thức này trả về tối đa 1.000 mô hình trên mỗi trang, ngay cả khi bạn truyền một pageSize lớn hơn.

pageToken string

Mã thông báo trang nhận được từ một lệnh gọi models.list trước đó.

Cung cấp pageToken do một yêu cầu trả về làm đối số cho yêu cầu tiếp theo để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho models.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Ví dụ về yêu cầu

Python

from google import genai

client = genai.Client()

print("List of models that support generateContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "generateContent":
            print(m.name)

print("List of models that support embedContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "embedContent":
            print(m.name)
models.py

Go

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}


// Retrieve the list of models.
models, err := client.Models.List(ctx, &genai.ListModelsConfig{})
if err != nil {
	log.Fatal(err)
}

fmt.Println("List of models that support generateContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "generateContent" {
			fmt.Println(m.Name)
			break
		}
	}
}

fmt.Println("\nList of models that support embedContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "embedContent" {
			fmt.Println(m.Name)
			break
		}
	}
}
models.go

Vỏ

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY
models.sh

Nội dung phản hồi

Phản hồi từ ListModel chứa danh sách Mô hình được phân trang.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Trường
models[] object (Model)

Các Mô hình được trả về.

nextPageToken string

Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo.

Nếu bạn bỏ qua trường này, thì sẽ không còn trang nào nữa.

Biểu diễn dưới dạng JSON 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

Tài nguyên REST: models

Tài nguyên: Mô hình

Thông tin về Mô hình ngôn ngữ tạo sinh.

Trường
name string

Bắt buộc. Tên tài nguyên của Model. Hãy tham khảo Biến thể mô hình để biết tất cả các giá trị được phép.

Định dạng: models/{model} có quy ước đặt tên {model} như sau:

  • "{baseModelId}-{version}"

Ví dụ:

  • models/gemini-1.5-flash-001
baseModelId string

Bắt buộc. Tên của mô hình cơ sở, hãy truyền tên này vào yêu cầu tạo.

Ví dụ:

  • gemini-1.5-flash
version string

Bắt buộc. Số phiên bản của mô hình.

Đây là phiên bản chính (1.0 hoặc 1.5)

displayName string

Tên dễ đọc của mô hình. Ví dụ: "Gemini 1.5 Flash".

Tên có thể dài tối đa 128 ký tự và có thể chứa mọi ký tự UTF-8.

description string

Nội dung mô tả ngắn về mô hình.

inputTokenLimit integer

Số lượng mã thông báo đầu vào tối đa được phép cho mô hình này.

outputTokenLimit integer

Số lượng mã thông báo đầu ra tối đa mà mô hình này có thể tạo ra.

supportedGenerationMethods[] string

Các phương thức tạo được mô hình hỗ trợ.

Tên phương thức API tương ứng được xác định là các chuỗi PascalCase, chẳng hạn như generateMessage và generateContent.

thinking boolean

Liệu mô hình có hỗ trợ suy nghĩ hay không.

temperature number

Kiểm soát tính ngẫu nhiên của kết quả.

Giá trị có thể nằm trong khoảng [0.0,maxTemperature], bao gồm cả giá trị này. Giá trị càng cao thì câu trả lời càng đa dạng, trong khi giá trị càng gần 0.0 thì câu trả lời của mô hình thường ít gây bất ngờ hơn. Giá trị này chỉ định giá trị mặc định mà phần phụ trợ sẽ sử dụng trong khi gọi đến mô hình.

maxTemperature number

Nhiệt độ tối đa mà mô hình này có thể sử dụng.

topP number

Đối với Lấy mẫu hạt nhân.

Lấy mẫu hạt nhân xem xét tập hợp mã thông báo nhỏ nhất có tổng xác suất ít nhất là topP. Giá trị này chỉ định giá trị mặc định mà phần phụ trợ sẽ sử dụng trong khi gọi đến mô hình.

topK integer

Đối với phương pháp lấy mẫu Top-k.

Phương pháp lấy mẫu k hàng đầu xem xét tập hợp topK mã thông báo có khả năng xảy ra nhất. Giá trị này chỉ định giá trị mặc định mà phần phụ trợ sẽ sử dụng trong khi gọi đến mô hình. Nếu trống, tức là mô hình không sử dụng phương pháp lấy mẫu top-k và topK không được phép làm tham số tạo.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "baseModelId": string,
  "version": string,
  "displayName": string,
  "description": string,
  "inputTokenLimit": integer,
  "outputTokenLimit": integer,
  "supportedGenerationMethods": [
    string
  ],
  "thinking": boolean,
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}