Điểm cuối của mô hình cung cấp cho bạn một cách để liệt kê các mô hình có sẵn 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ổ ngữ 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ề mô hình Gemini để biết thông tin chi tiết về mô hình.
Điểm cuối
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=models /*}
URL sử dụng cú pháp Chuyển mã gRPC.
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}
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
Vỏ
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ê các Model
có sẵn thông qua Gemini API.
Điểm cuối
gethttps: / /generativelanguage.googleapis.com /v1beta /models
URL sử dụng cú pháp Chuyển mã gRPC.
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, hệ thống sẽ trả về 50 mẫu 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ừ 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
Vỏ
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:
models[]
object (Model
)
Các 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 bạn bỏ qua trường này, thì sẽ không có trang nào khác.
Biểu diễn dưới dạng JSON |
---|
{
"models": [
{
object ( |
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.
name
string
Bắt buộc. Tên tài nguyên của Model
. Hãy tham khảo phần Biến thể 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 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.
Giá trị này đại diện cho phiên bản chính (1.0
hoặc 1.5
)
displayName
string
Tên mô hình mà con người đọ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
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 có sẵn 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 xác định là chuỗi PascalCase, chẳng hạn như generateMessage
và generateContent
.
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 từ [0.0,maxTemperature]
trở lên. Giá trị cao hơn 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
thường sẽ dẫn đến các câu trả lời ít bất ngờ hơn từ mô hình. Giá trị này chỉ định giá trị mặc định mà phần phụ trợ sẽ sử dụng trong 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 hạt nhân.
Tính năng 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 thực hiện lệnh gọi đến mô hình.
topK
integer
Đối với phương thức lấy mẫu Top-k.
Tính năng lấy mẫu top-k xem xét tập hợp các mã thông báo topK
có nhiều khả năng nhất. Giá trị này chỉ định giá trị mặc định mà phần phụ trợ sẽ sử dụng trong khi thực hiện lệnh gọi đến mô hình. Nếu để trống, cho biết mô hình không sử dụng phương pháp lấy mẫu top-k và không cho phép topK
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 } |