Models

Điểm cuối của mô hình cung cấp cho bạn cách lập trình để liệt kê các mô hình hiện có 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ổ ngữ cảnh. Hãy đọc thêm trong hướng dẫn về Mẫu sản phẩm.

Phương thức: model.get

Lấy thông tin về một Model cụ thể, chẳng hạn như số phiên bản, giới hạn về mã thông báo, các thông 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

nhận 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 được 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.

Yêu cầu mẫu

Python

model_info = genai.get_model("models/gemini-1.5-flash-latest")
print(model_info)
models.py

Vỏ

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash?key=$GOOGLE_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: model.list

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

Điểm cuối

nhận 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 bạn không chỉ định, hệ thống sẽ trả về 50 kiểu máy trên mỗi trang. Phương thức này trả về tối đa 1.000 mẫu trên mỗi trang, ngay cả khi bạn chuyển pageSize lớn hơn.

pageToken string

Mã thông báo trang, nhận được 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.

Yêu cầu mẫu

Python

print("List of models that support generateContent:\n")
for m in genai.list_models():
    if "generateContent" in m.supported_generation_methods:
        print(m.name)

print("List of models that support embedContent:\n")
for m in genai.list_models():
    if "embedContent" in m.supported_generation_methods:
        print(m.name)
models.py

Vỏ

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

Nội dung phản hồi

Phản hồi của 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:

Số trường
models[] object (Model)

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

nextPageToken string

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

Nếu trường này bị bỏ qua, thì sẽ không có trang nào khác.

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

Tài nguyên REST: mô hình

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

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

Số 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ể của mô hình để biết tất cả các giá trị được phép.

Định dạng: models/{model} với quy ước đặt tên {model} là:

  • "{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ở, truyền giá trị này đến 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 lớn (1.0 hoặc 1.5)

displayName string

Tên mô hình mà con người có thể đọc được. Ví dụ: "Gemini 1.5 Flash".

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

description string

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 hiện có cho mô hình này.

supportedGenerationMethods[] string

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

Tên phương thức API tương ứng được định nghĩa là chuỗi viết hoa Pascal, chẳng hạn như generateMessage và generateContent.

temperature number

Kiểm soát độ ngẫu nhiên của dữ liệu đầu ra.

Các giá trị có thể dao động trên [0.0,maxTemperature], tính cả hai giá trị đó. Giá trị càng cao sẽ tạo ra các câu trả lời đa dạng hơn, trong khi giá trị gần với 0.0 hơn thường sẽ khiến mô hình đưa ra các câu trả lời í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 khi thực hiện lệnh 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 nhân tố.

Phương pháp lấy mẫu hạt nhân sẽ 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 khi thực hiện lệnh gọi đến mô hình.

topK integer

Đối với việc lấy mẫu Top-k.

Phương pháp lấy mẫu hàng đầu sẽ xem xét tập hợp topK mã thông báo có khả năng có nhiều nhất. Giá trị này chỉ định giá trị mặc định mà phần phụ trợ sẽ sử dụng khi thực hiện lệnh gọi đến mô hình. Nếu trống, điều này cho biết mô hình không sử dụng phương pháp lấy mẫu hàng đầu 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
  ],
  "temperature": number,
  "maxTemperature": number,
  "topP": number,
  "topK": integer
}