Models

메서드: models.get

특정 모델에 대한 정보를 가져옵니다.

엔드포인트

<ph type="x-smartling-placeholder"></ph> 받기 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)

Shell

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

응답 본문

성공한 경우 응답 본문에 Model의 인스턴스가 포함됩니다.

메서드: models.list

API를 통해 사용할 수 있는 모델을 나열합니다.

엔드포인트

<ph type="x-smartling-placeholder"></ph> 받기 https://generativelanguage.googleapis.com/v1beta/models

쿼리 매개변수

pageSize integer

페이지당 반환할 최대 Models 수입니다.

서비스가 더 적은 수의 모델을 반환할 수 있습니다. 지정하지 않으면 페이지당 최대 50개의 모델이 반환됩니다. 이 메서드는 더 큰 pageSize를 전달하더라도 페이지당 최대 1, 000개의 모델을 반환합니다.

pageToken string

이전 models.list 호출에서 받은 페이지 토큰입니다.

한 요청에서 반환된 pageToken를 다음 요청의 인수로 제공하여 다음 페이지를 검색합니다.

페이지를 매길 때 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)

Shell

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 리소스: models

리소스: Model

생성형 언어 모델에 관한 정보입니다.

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의 리소스 이름입니다.

형식: 다음과 같은 {model} 이름 지정 규칙을 사용하는 models/{model}

  • &quot;{baseModelId}-{version}&quot;

예:

  • models/chat-bison-001
baseModelId string

필수 항목입니다. 기본 모델의 이름으로, 생성 요청에 전달합니다.

예:

  • chat-bison
version string

필수 항목입니다. 모델의 버전 번호입니다.

이는 Cloud Shell의

displayName string

사람이 읽을 수 있는 모델 이름입니다. 예: "채팅 들러리".

이름은 최대 128자(영문 기준)까지 가능하며 UTF-8 문자를 포함할 수 있습니다.

description string

모델에 대한 간단한 설명입니다.

inputTokenLimit integer

이 모델에 허용되는 최대 입력 토큰 수입니다.

outputTokenLimit integer

이 모델에 사용할 수 있는 최대 출력 토큰 수입니다.

supportedGenerationMethods[] string

모델에서 지원되는 생성 메서드입니다.

메서드 이름은 파스칼 표기법 문자열(예: generateMessage)로 정의되며 API 메서드에 해당합니다.

temperature number

출력의 무작위성을 제어합니다.

값의 범위는 [0.0,maxTemperature](양 끝값 포함)입니다. 값이 클수록 더 다양한 응답이 생성되는 반면, 0.0에 가까울수록 일반적으로 모델에서 예상치 못한 응답을 얻게 됩니다. 이 값은 모델을 호출하는 동안 백엔드에서 사용할 기본값을 지정합니다.

maxTemperature number

이 모델이 사용할 수 있는 최고 온도입니다.

topP number

Nucleus 샘플링

핵 샘플링에서는 확률 합계가 topP 이상인 가장 작은 토큰 집합을 고려합니다. 이 값은 모델을 호출하는 동안 백엔드에서 사용할 기본값을 지정합니다.

topK integer

Top-k 샘플링.

Top-k 샘플링은 확률이 가장 높은 topK 토큰 집합을 고려합니다. 이 값은 모델을 호출하는 동안 백엔드에서 사용할 기본값을 지정합니다. 비어 있으면 모델이 최상위 k 샘플링을 사용하지 않으며 topK이 생성 매개변수로 허용되지 않음을 나타냅니다.