Models

เมธอด: model.get

รับข้อมูลเกี่ยวกับรุ่นที่เจาะจง

ปลายทาง

ซื้อ https://generativelanguage.googleapis.com/v1beta/{name=models/*}

พารามิเตอร์เส้นทาง

name string

ต้องระบุ ชื่อทรัพยากรของโมเดล

ชื่อนี้ควรตรงกับชื่อโมเดลที่แสดงผลโดยเมธอด models.list

รูปแบบ: models/{model} จะอยู่ในรูปแบบ models/{model}

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

ตัวอย่างคำขอ

Python

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

เปลือกหอย

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro?key=$GOOGLE_API_KEY

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Model

เมธอด: images.list

แสดงรายการโมเดลที่พร้อมใช้งานผ่าน API

ปลายทาง

ซื้อ https://generativelanguage.googleapis.com/v1beta/models

พารามิเตอร์การค้นหา

pageSize integer

จำนวนสูงสุด Models ที่จะแสดงผล (ต่อหน้า)

บริการอาจแสดงโมเดลน้อยลง หากไม่ระบุ ระบบจะแสดงผลโมเดลมากที่สุด 50 โมเดลต่อหน้า เมธอดนี้จะแสดงโมเดลสูงสุด 1, 000 รายการต่อหน้า แม้ว่าคุณจะส่ง pageSize ที่ใหญ่กว่าก็ตาม

pageToken string

โทเค็นของหน้าเว็บที่ได้รับจากการโทร models.list ก่อนหน้า

ระบุ pageToken ที่ส่งคืนโดยคำขอ 1 รายการเป็นอาร์กิวเมนต์ของคำขอถัดไปเพื่อเรียกหน้าถัดไป

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ models.list ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

ตัวอย่างคำขอ

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)

เปลือกหอย

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

เนื้อหาการตอบกลับ

การตอบกลับจาก ListModel ที่มีรายการโมเดลที่ใส่เลขหน้า

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

ช่อง
models[] object (Model)

โมเดลที่แสดงผล

nextPageToken string

โทเค็นซึ่งสามารถส่งเป็น pageToken เพื่อเรียกข้อมูลหน้าถัดไป

หากเว้นช่องนี้ไว้ จะไม่มีหน้าเพิ่มเติม

การแสดง JSON 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

ทรัพยากร REST: โมเดล

แหล่งข้อมูล: โมเดล

ข้อมูลเกี่ยวกับโมเดลภาษา Generative

การแสดง 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

ต้องระบุ ชื่อทรัพยากรของ Model

รูปแบบ: models/{model} ที่มีรูปแบบการตั้งชื่อ {model} ดังต่อไปนี้

  • "{baseModelId}-{version}"

ตัวอย่าง

  • models/chat-bison-001
baseModelId string

ต้องระบุ ชื่อของโมเดลฐาน ส่งต่อค่านี้ไปยังคำขอสร้าง

ตัวอย่าง

  • chat-bison
version string

ต้องระบุ หมายเลขเวอร์ชันของโมเดล

ส่วนนี้แสดงเวอร์ชันหลัก

displayName string

ชื่อโมเดลที่มนุษย์อ่านได้ เช่น "Chat Bison"

ชื่อมีความยาวได้สูงสุด 128 อักขระและประกอบด้วยอักขระ UTF-8 ใดก็ได้

description string

คำอธิบายสั้นๆ ของโมเดล

inputTokenLimit integer

จำนวนโทเค็นอินพุตสูงสุดที่อนุญาตสำหรับโมเดลนี้

outputTokenLimit integer

จำนวนโทเค็นเอาต์พุตสูงสุดที่พร้อมใช้งานสำหรับโมเดลนี้

supportedGenerationMethods[] string

วิธีการสร้างที่โมเดลรองรับ

ชื่อเมธอดจะระบุเป็นสตริงตัวพิมพ์เล็ก/ใหญ่แบบ Pascal เช่น generateMessage ซึ่งสอดคล้องกับเมธอด API

temperature number

ควบคุมการสุ่มของเอาต์พุต

ค่าต้องอยู่ในช่วง [0.0,maxTemperature] ขึ้นไป (รวมค่าแรกและค่าสุดท้าย) ค่าที่สูงกว่าจะให้คำตอบที่หลากหลายมากขึ้น ส่วนค่าที่ใกล้กับ 0.0 มักจะทำให้ได้คำตอบที่ไม่น่าประหลาดใจจากโมเดลน้อยลง ค่านี้จะระบุค่าเริ่มต้นที่จะใช้โดยแบ็กเอนด์ขณะทำการเรียกใช้โมเดล

maxTemperature number

อุณหภูมิสูงสุดที่โมเดลนี้ใช้ได้

topP number

สำหรับการสุ่มตัวอย่างนิวเคลียส

การสุ่มตัวอย่างนิวเคลียสจะพิจารณาชุดโทเค็นที่น้อยที่สุดซึ่งมีผลรวมความน่าจะเป็นอย่างน้อย topP ค่านี้จะระบุค่าเริ่มต้นที่จะใช้โดยแบ็กเอนด์ขณะทำการเรียกใช้โมเดล

topK integer

สำหรับการสุ่มตัวอย่างแบบ Top-k

การสุ่มตัวอย่างแบบ Top-k จะพิจารณาชุดโทเค็นที่เป็นไปได้มากที่สุด topK รายการ ค่านี้จะระบุค่าเริ่มต้นที่จะใช้โดยแบ็กเอนด์ขณะทำการเรียกใช้โมเดล หากเว้นว่างไว้ หมายความว่าโมเดลไม่ได้ใช้การสุ่มตัวอย่างในตำแหน่งบนสุด (top-k) และไม่อนุญาตให้ใช้ topK เป็นพารามิเตอร์การสร้าง