Phương thức: model.get
Lấy thông tin về một Mô hình cụ thể.
Đ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
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: model.list
Liệt kê các mô hình có sẵn thông qua API.
Đ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).
Dịch vụ có thể trả về ít mô hình hơn. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 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
Vỏ
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:
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 ( |
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.
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 } |
name
string
Bắt buộc. Tên tài nguyên của Model
.
Định dạng: models/{model}
với quy ước đặt tên {model}
là:
- "{baseModelId}-{version}"
Ví dụ:
models/chat-bison-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ụ:
chat-bison
version
string
Bắt buộc. Số phiên bản của mô hình.
Biểu tượng này đại diện cho phiên bản lớn
displayName
string
Tên mô hình mà con người có thể đọc được. Ví dụ: "Trò chuyện với Bison".
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 được khai báo là chuỗi viết hoa Pascal, chẳng hạn như generateMessage
tương ứng với các phương thức API.
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ẽ mang lại 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 việc lấy mẫu Hạt nhân.
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.
Tính năng 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 xuất hiện 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.