ปลายทางของโมเดลช่วยให้คุณแสดงรายการโมเดลที่มีอยู่โดยใช้โปรแกรม และดึงข้อมูลเมตาเพิ่มเติม เช่น ฟังก์ชันการทำงานที่รองรับและการกำหนดขนาดหน้าต่างบริบท อ่านเพิ่มเติมในคู่มือโมเดล
เมธอด: models.get
รับข้อมูลเกี่ยวกับ Model ที่เฉพาะเจาะจง เช่น หมายเลขเวอร์ชัน ขีดจำกัดโทเค็น พารามิเตอร์ และข้อมูลเมตาอื่นๆ ดูข้อมูลโมเดลโดยละเอียดได้ในคำแนะนำเกี่ยวกับโมเดล Gemini
ปลายทาง
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=models /*}
พารามิเตอร์เส้นทาง
name
string
ต้องระบุ ชื่อทรัพยากรของโมเดล
ชื่อนี้ควรตรงกับชื่อโมเดลที่เมธอด models.list แสดงผล
รูปแบบ: models/{model} ซึ่งจะอยู่ในรูปแบบ models/{model}
เนื้อความของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
ตัวอย่างคำขอ
Python
Go
เปลือกหอย
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Model
เมธอด: models.list
แสดงรายการ Models ที่พร้อมใช้งานผ่าน Gemini API
ปลายทาง
gethttps: / /generativelanguage.googleapis.com /v1beta /models
พารามิเตอร์การค้นหา
pageSize
integer
จำนวนสูงสุดของ Models ที่จะแสดง (ต่อหน้า)
หากไม่ระบุ ระบบจะแสดงผลโมเดล 50 รายการต่อหน้า วิธีนี้จะแสดงโมเดลสูงสุด 1, 000 รายการต่อหน้า แม้ว่าคุณจะส่ง pageSize ที่ใหญ่กว่าก็ตาม
pageToken
string
โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ models.list ก่อนหน้า
ระบุ pageToken ที่ส่งคืนโดยคำขอหนึ่งเป็นอาร์กิวเมนต์ของคำขอถัดไปเพื่อดึงข้อมูลหน้าถัดไป
เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ models.list ต้องตรงกับการเรียกที่ให้โทเค็นหน้าเว็บ
เนื้อความของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
ตัวอย่างคำขอ
Python
Go
เปลือกหอย
เนื้อหาการตอบกลับ
การตอบกลับจาก 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 Case เช่น generateMessage และ generateContent
thinking
boolean
โมเดลรองรับการคิดหรือไม่
temperature
number
ควบคุมความสุ่มของเอาต์พุต
ค่าที่ใช้ได้อยู่ในช่วง [0.0,maxTemperature] ค่าที่สูงขึ้นจะสร้างคำตอบที่หลากหลายมากขึ้น ขณะที่ค่าที่ใกล้กับ 0.0 โดยทั่วไปจะทำให้โมเดลสร้างคำตอบที่น่าประหลาดใจน้อยลง ค่านี้จะระบุค่าเริ่มต้นที่แบ็กเอนด์ใช้ขณะทำการเรียกไปยังโมเดล
maxTemperature
number
อุณหภูมิสูงสุดที่โมเดลนี้ใช้ได้
topP
number
สำหรับการสุ่มตัวอย่าง Nucleus
การสุ่มตัวอย่างนิวเคลียสจะพิจารณาชุดโทเค็นที่เล็กที่สุดซึ่งมีผลรวมความน่าจะเป็นอย่างน้อย 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 ], "thinking": boolean, "temperature": number, "maxTemperature": number, "topP": number, "topK": integer } |
เมธอด: models.predict
ดำเนินการคำขอการคาดการณ์
ปลายทาง
โพสต์https: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predict
พารามิเตอร์เส้นทาง
model
string
ต้องระบุ ชื่อของโมเดลสำหรับการคาดการณ์ รูปแบบ: name=models/{model} ซึ่งจะอยู่ในรูปแบบ models/{model}
เนื้อความของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
instances[]
value (Value format)
ต้องระบุ อินสแตนซ์ที่เป็นอินพุตของการเรียกการคาดการณ์
parameters
value (Value format)
ไม่บังคับ พารามิเตอร์ที่ควบคุมการเรียกการคาดการณ์
เนื้อหาการตอบกลับ
ข้อความตอบกลับสำหรับ [PredictionService.Predict]
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
predictions[]
value (Value format)
เอาต์พุตของการเรียกใช้การคาดการณ์
| การแสดง JSON |
|---|
{ "predictions": [ value ] } |
เมธอด: models.predictLongRunning
เช่นเดียวกับ models.predict แต่จะแสดงผล LRO
ปลายทาง
โพสต์https: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictLongRunning
พารามิเตอร์เส้นทาง
model
string
ต้องระบุ ชื่อของโมเดลสำหรับการคาดการณ์ รูปแบบ: name=models/{model}
เนื้อความของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
instances[]
value (Value format)
ต้องระบุ อินสแตนซ์ที่เป็นอินพุตของการเรียกการคาดการณ์
parameters
value (Value format)
ไม่บังคับ พารามิเตอร์ที่ควบคุมการเรียกการคาดการณ์
webhookConfig.uris[]
string
ไม่บังคับ หากตั้งค่าไว้ ระบบจะใช้ URI ของเว็บฮุคเหล่านี้สำหรับเหตุการณ์เว็บฮุคแทนเว็บฮุคที่ลงทะเบียน
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation