Models

Pika fundore 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ç janë funksionaliteti i mbështetur dhe madhësia e dritares së kontekstit. Lexoni më shumë në udhëzuesin e Modeleve .

Metoda: models.get

Merr informacion në lidhje me një Model specifik, siç është numri i versionit të tij, kufijtë e tokenëve, parametrat dhe meta të dhëna të tjera. Referojuni udhëzuesit të modeleve Gemini për informacion të detajuar të modelit.

Pika e Fundit

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

Parametrat e shtegut

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 kërkese

Python 

from google import genai

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

Shko 

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

Guaskë 

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

Trupi i përgjigjes

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

Metoda: models.list

Liston Model e disponueshme përmes Gemini API.

Pika e Fundit

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

Parametrat e pyetjes

Madhësia pageSize integer

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

Nëse nuk specifikohet, do të kthehen 50 modele për faqe. Kjo metodë kthen maksimumi 1000 modele për faqe, edhe nëse kaloni një pageSize më të madhe.

vargu i pageToken string

Një shenjë faqeje, e marrë nga një thirrje 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ë faqosjes, të gjithë parametrat e tjerë të dhënë te models.list duhet të përputhen me thirrjen që ofroi tokenin e faqes.

Trupi i kërkesës

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

Shembull kërkese

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

Shko 

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

Guaskë 

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

Trupi i përgjigjes

Përgjigje nga ListModel që përmban një listë të faqezuar 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ë token, i cili mund të dërgohet si pageToken për të marrë faqen tjetër.

Nëse kjo fushë lihet jashtë, nuk ka më faqe.

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

Burimi REST: modele

Burimi: Modeli

Informacion rreth një Modeli Gjuhësor Gjenerativ.

Fushat
string name

E detyrueshme. Emri i burimit të Model . Referojuni Variantet e 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ë, kalojeni këtë te kërkesa e gjenerimit.

Shembuj:

  • gemini-1.5-flash
string version

E detyrueshme. Numri i versionit të modelit.

Kjo 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 i gjatë 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 tokenëve të hyrjes të lejuar për këtë model.

outputTokenLimit integer

Numri maksimal i tokenëve të daljes në dispozicion për këtë model.

string supportedGenerationMethods[]

Metodat e gjenerimit të mbështetura nga modeli.

Emrat përkatës të metodave API përcaktohen si vargje të shkronjave të mëdha në Pascal, të tilla si generateMessage dhe generateContent .

thinking boolean

Nëse modeli mbështet të menduarit.

number temperature

Kontrollon rastësinë e rezultatit.

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ë larmishme, ndërsa një vlerë më afër 0.0 zakonisht do të rezultojë në përgjigje më pak të papritura nga modeli. Kjo vlerë përcakton parazgjedhjen që do të përdoret nga backend gjatë thirrjes në model.

number maxTemperature

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

number topP

Për marrjen e mostrave të bërthamës .

Marrja e mostrave bërthamore merr në konsideratë grupin më të vogël të tokenëve, shuma e probabilitetit të të cilëve është të paktën topP . Kjo vlerë përcakton parazgjedhjen që do të përdoret nga backend gjatë thirrjes së modelit.

integer topK

Për marrjen e mostrave Top-k.

Kampionimi Top-k merr në konsideratë bashkësinë e tokenëve më të mundshëm topK . Kjo vlerë përcakton vlerën e parazgjedhur që do të përdoret nga backend gjatë thirrjes së modelit. Nëse është 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: modele.parashikim

Kryen një kërkesë parashikimi.

Pika e Fundit

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

Parametrat e shtegut

string model

E detyrueshme. Emri i modelit për parashikim. Formati: name=models/{model} . 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
instances[] value ( Value format)

E detyrueshme. Instancat që janë hyrja në thirrjen e parashikimit.

parameters value ( Value format)

Opsionale. Parametrat që drejtojnë thirrjen e parashikimit.

Trupi i përgjigjes

Mesazh përgjigjeje 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
predictions[] value ( Value format)

Rezultatet e thirrjes së parashikimit.

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

Metoda: models.predictLongRunning

Njësoj si models.predict por kthen një LRO.

Pika e Fundit

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

Parametrat e shtegut

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
instances[] value ( Value format)

E detyrueshme. Instancat që janë hyrja në thirrjen e parashikimit.

parameters value ( Value format)

Opsionale. Parametrat që drejtojnë thirrjen e parashikimit.

Trupi i përgjigjes

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