Models

Pika përfundimtare e modeleve ofron një mënyrë që ju të listoni në mënyrë programore modelet e disponueshme dhe të merrni meta të dhëna të zgjeruara si funksionaliteti i mbështetur dhe madhësia e dritares së kontekstit. Lexoni më shumë në udhëzuesin e Modeleve .

Metoda: modele.marr

Merr informacione rreth një Model specifik, si numri i versionit të tij, kufijtë e shenjave, parametrat dhe të dhënat e tjera meta. Referojuni udhëzuesit të modeleve Gemini për informacion të detajuar të modelit.

Pika përfundimtare

merrni https: / /generativelanguage.googleapis.com /v1beta /{name=models /*}

Parametrat e rrugës

string name

E detyrueshme. Emri i burimit të modelit.

Ky emër duhet të përputhet me një emër modeli të kthyer nga metoda models.list .

Formati: models/{model} Merr formën models/{model} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Shembull i kërkesës

Python 

from google import genai

client = genai.Client()
model_info = client.models.get(model="gemini-2.0-flash")
print(model_info)
models.py

Shkoni 

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}

modelInfo, err := client.Models.Get(ctx, "gemini-2.0-flash", nil)
if err != nil {
	log.Fatal(err)
}

fmt.Println(modelInfo)
models.go

Shell 

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash?key=$GEMINI_API_KEY
models.sh

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Model .

Metoda: modelet.lista

Liston Model e disponueshme përmes Gemini API.

Pika përfundimtare

merrni https: / /generativelanguage.googleapis.com /v1beta /models

Parametrat e pyetjes

integer pageSize

Numri maksimal i Models për t'u kthyer (për faqe).

Nëse nuk specifikohet, 50 modele do të kthehen për faqe. Kjo metodë kthen më së shumti 1000 modele për faqe, edhe nëse kaloni një madhësi më të madhe të faqes.

vargu string pageToken

Një shenjë faqeje, e marrë nga një telefonatë e mëparshme models.list .

Jepni pageToken të kthyer nga një kërkesë si argument për kërkesën tjetër për të marrë faqen tjetër.

Gjatë paginimit, të gjithë parametrat e tjerë të dhënë models.list duhet të përputhen me thirrjen që ka dhënë tokenin e faqes.

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Shembull i kërkesës

Python 

from google import genai

client = genai.Client()

print("List of models that support generateContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "generateContent":
            print(m.name)

print("List of models that support embedContent:\n")
for m in client.models.list():
    for action in m.supported_actions:
        if action == "embedContent":
            print(m.name)
models.py

Shkoni 

ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
	APIKey:  os.Getenv("GEMINI_API_KEY"),
	Backend: genai.BackendGeminiAPI,
})
if err != nil {
	log.Fatal(err)
}


// Retrieve the list of models.
models, err := client.Models.List(ctx, &genai.ListModelsConfig{})
if err != nil {
	log.Fatal(err)
}

fmt.Println("List of models that support generateContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "generateContent" {
			fmt.Println(m.Name)
			break
		}
	}
}

fmt.Println("\nList of models that support embedContent:")
for _, m := range models.Items {
	for _, action := range m.SupportedActions {
		if action == "embedContent" {
			fmt.Println(m.Name)
			break
		}
	}
}
models.go

Shell 

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

Trupi i reagimit

Përgjigje nga ListModel që përmban një listë të faqeve të Modeleve.

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
models[] object ( Model )

Modelet e kthyera.

string nextPageToken

Një shenjë, e cila mund të dërgohet si pageToken për të tërhequr faqen tjetër.

Nëse kjo fushë hiqet, nuk ka më faqe.

Përfaqësimi JSON 
{
  "models": [
    {
      object (Model)
    }
  ],
  "nextPageToken": string
}

Burimi REST: modele

Burimi: Model

Informacion në lidhje me një model gjuhësor gjenerues.

Fushat
string name

E detyrueshme. Emri i burimit të Model . Referojuni varianteve të modelit për të gjitha vlerat e lejuara.

Formati: models/{model} me një konventë emërtimi {model} prej:

  • "{baseModelId}-{version}"

Shembuj:

  • models/gemini-1.5-flash-001
string baseModelId

E detyrueshme. Emri i modelit bazë, kaloni këtë në kërkesën e gjenerimit.

Shembuj:

  • gemini-1.5-flash
string version

E detyrueshme. Numri i versionit të modelit.

Ky përfaqëson versionin kryesor ( 1.0 ose 1.5 )

string displayName

Emri i modelit i lexueshëm nga njeriu. P.sh. "Gemini 1.5 Flash".

Emri mund të jetë deri në 128 karaktere dhe mund të përbëhet nga çdo karakter UTF-8.

string description

Një përshkrim i shkurtër i modelit.

inputTokenLimit integer

Numri maksimal i shenjave hyrëse të lejuara për këtë model.

outputTokenLimit integer

Numri maksimal i shenjave dalëse të disponueshme për këtë model.

string supportedGenerationMethods[]

Metodat e gjenerimit të mbështetur nga modeli.

Emrat përkatës të metodës API përcaktohen si vargje të rasteve Pascal, të tilla si generateMessage dhe generateContent .

thinking boolean

Nëse modeli mbështet të menduarit.

number temperature

Kontrollon rastësinë e daljes.

Vlerat mund të variojnë mbi [0.0,maxTemperature] , përfshirëse. Një vlerë më e lartë do të prodhojë përgjigje që janë më të ndryshme, ndërsa një vlerë më afër 0.0 zakonisht do të rezultojë në përgjigje më pak befasuese nga modeli. Kjo vlerë specifikon parazgjedhjen që do të përdoret nga backend gjatë kryerjes së thirrjes në model.

number maxTemperature

Temperatura maksimale që mund të përdorë ky model.

number topP

Për kampionimin e bërthamës .

Kampionimi i bërthamës merr në konsideratë grupin më të vogël të argumenteve, shuma e probabilitetit të të cilëve është të paktën topP . Kjo vlerë specifikon parazgjedhjen që do të përdoret nga backend gjatë kryerjes së thirrjes në model.

topK integer

Për kampionimin Top-k.

Mostra Top-k merr në konsideratë grupin e tokenëve më të mundshëm topK . Kjo vlerë specifikon parazgjedhjen që do të përdoret nga backend gjatë kryerjes së thirrjes në model. Nëse bosh, tregon se modeli nuk përdor kampionimin top-k dhe topK nuk lejohet si parametër gjenerimi.

Përfaqësimi 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
}

Metoda: modelet.parashikojnë

Kryen një kërkesë parashikimi.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predict

Parametrat e rrugës

string model

E detyrueshme. Emri i modelit për parashikim. Formati: name=models/{model} . Ajo merr formën models/{model} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
value ( Value format) instances[] (Formati i vlerës)

E detyrueshme. Rastet që janë hyrje në thirrjen e parashikimit.

vlera parameters value ( Value format)

Fakultative. Parametrat që rregullojnë thirrjen e parashikimit.

Trupi i reagimit

Mesazhi i përgjigjes për [PredictionService.Predict].

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
value ( Value format) predictions[] (Formati i vlerës)

Rezultatet e thirrjes së parashikimit.

Përfaqësimi JSON 
{
  "predictions": [
    value
  ]
}

Metoda: modele.predictLongRunning

Njësoj si modelet.parashikojnë por kthen një LRO.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{model=models /*}:predictLongRunning

Parametrat e rrugës

string model

E detyrueshme. Emri i modelit për parashikim. Formati: name=models/{model} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
value ( Value format) instances[] (Formati i vlerës)

E detyrueshme. Rastet që janë hyrje në thirrjen e parashikimit.

vlera parameters value ( Value format)

Fakultative. Parametrat që rregullojnë thirrjen e parashikimit.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Operation .