ปลายทางของโมเดลช่วยให้คุณแสดงรายการโมเดลที่มีอยู่แบบเป็นโปรแกรมและเรียกข้อมูลเมตาแบบขยาย เช่น ฟังก์ชันการทำงานที่รองรับและการปรับขนาดหน้าต่างบริบท อ่านเพิ่มเติมในคู่มือโมเดล
เมธอด: collections.get
รับข้อมูลเกี่ยวกับ Model
ที่เจาะจง เช่น หมายเลขเวอร์ชัน ขีดจำกัดของโทเค็น พารามิเตอร์ และข้อมูลเมตาอื่นๆ ดูรายละเอียดโมเดลได้ในคู่มือโมเดล Gemini
ปลายทาง
ซื้อ
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
พารามิเตอร์เส้นทาง
name
string
ต้องระบุ ชื่อทรัพยากรของโมเดล
ชื่อนี้ควรตรงกับชื่อโมเดลที่แสดงผลโดยเมธอด models.list
รูปแบบ: models/{model}
จะอยู่ในรูปแบบ models/{model}
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
ตัวอย่างคำขอ
Python
เปลือกหอย
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Model
เมธอด: model.list
แสดงรายการ Model
ที่พร้อมใช้งานผ่าน Gemini API
ปลายทาง
ซื้อ
https://generativelanguage.googleapis.com/v1beta/models
พารามิเตอร์การค้นหา
pageSize
integer
จำนวนสูงสุด Models
ที่จะแสดงผล (ต่อหน้า)
หากไม่ระบุ ระบบจะแสดงผลโมเดล 50 รายการต่อหน้า เมธอดนี้จะแสดงโมเดลสูงสุด 1, 000 รายการต่อหน้า แม้ว่าคุณจะส่ง pageSize ที่ใหญ่กว่าก็ตาม
pageToken
string
โทเค็นของหน้าเว็บที่ได้รับจากการโทร models.list
ก่อนหน้า
ระบุ pageToken
ที่ส่งคืนโดยคำขอ 1 รายการเป็นอาร์กิวเมนต์ของคำขอถัดไปเพื่อเรียกหน้าถัดไป
เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ models.list
ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
ตัวอย่างคำขอ
Python
เปลือกหอย
เนื้อหาการตอบกลับ
การตอบกลับจาก ListModel
ที่มีรายการโมเดลที่ใส่เลขหน้า
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
models[]
object (Model
)
โมเดลที่แสดงผล
nextPageToken
string
โทเค็นซึ่งสามารถส่งเป็น pageToken
เพื่อเรียกข้อมูลหน้าถัดไป
หากเว้นช่องนี้ไว้ จะไม่มีหน้าเพิ่มเติม
การแสดง JSON |
---|
{
"models": [
{
object ( |
ทรัพยากร REST: โมเดล
แหล่งข้อมูล: โมเดล
ข้อมูลเกี่ยวกับโมเดลภาษา Generative
name
string
ต้องระบุ ชื่อทรัพยากรของ Model
โปรดดูตัวแปรรุ่นสำหรับค่าที่อนุญาตทั้งหมด
รูปแบบ: models/{model}
ที่มีรูปแบบการตั้งชื่อ {model}
ดังต่อไปนี้
- "{baseModelId}-{version}"
ตัวอย่าง
models/gemini-1.5-flash-001
baseModelId
string
ต้องระบุ ชื่อของโมเดลฐาน ส่งต่อค่านี้ไปยังคำขอสร้าง
ตัวอย่าง
gemini-1.5-flash
version
string
ต้องระบุ หมายเลขเวอร์ชันของโมเดล
แสดงเวอร์ชันหลัก (1.0
หรือ 1.5
)
displayName
string
ชื่อโมเดลที่มนุษย์อ่านได้ เช่น "Gemini 1.5 Flash"
ชื่อมีความยาวได้สูงสุด 128 อักขระและประกอบด้วยอักขระ UTF-8 ใดก็ได้
description
string
คำอธิบายสั้นๆ ของโมเดล
inputTokenLimit
integer
จำนวนโทเค็นอินพุตสูงสุดที่อนุญาตสำหรับโมเดลนี้
outputTokenLimit
integer
จำนวนโทเค็นเอาต์พุตสูงสุดที่พร้อมใช้งานสำหรับโมเดลนี้
supportedGenerationMethods[]
string
วิธีการสร้างที่โมเดลรองรับ
ชื่อเมธอด API ที่เกี่ยวข้องจะกำหนดเป็นสตริงตัวพิมพ์เล็ก/ใหญ่แบบ Pascal เช่น generateMessage
และ generateContent
temperature
number
ควบคุมการสุ่มของเอาต์พุต
ค่าต้องอยู่ในช่วง [0.0,maxTemperature]
ขึ้นไป (รวมค่าแรกและค่าสุดท้าย) ค่าที่สูงกว่าจะให้คำตอบที่หลากหลายมากขึ้น ส่วนค่าที่ใกล้กับ 0.0
มักจะทำให้ได้คำตอบที่ไม่น่าประหลาดใจจากโมเดลน้อยลง ค่านี้จะระบุค่าเริ่มต้นที่จะใช้โดยแบ็กเอนด์ขณะทำการเรียกใช้โมเดล
maxTemperature
number
อุณหภูมิสูงสุดที่โมเดลนี้ใช้ได้
topP
number
สำหรับการสุ่มตัวอย่างนิวเคลียส
การสุ่มตัวอย่างนิวเคลียสจะพิจารณาชุดโทเค็นที่เล็กที่สุดที่มีผลรวมความน่าจะเป็นอย่างน้อย topP
ค่านี้จะระบุค่าเริ่มต้นที่จะใช้โดยแบ็กเอนด์ขณะทำการเรียกใช้โมเดล
topK
integer
สำหรับการสุ่มตัวอย่างแบบ Top-k
การสุ่มตัวอย่างแบบ Top-k จะพิจารณาชุดโทเค็นที่เป็นไปได้มากที่สุด topK
รายการ ค่านี้จะระบุค่าเริ่มต้นที่จะใช้โดยแบ็กเอนด์ขณะทำการเรียกใช้โมเดล หากเว้นว่างไว้ หมายความว่าโมเดลไม่ได้ใช้การสุ่มตัวอย่างในตำแหน่งบนสุด (top-k) และไม่อนุญาตให้ใช้ topK
เป็นพารามิเตอร์การสร้าง
การแสดง 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 } |