모델 엔드포인트를 사용하면 사용 가능한 모델을 프로그래매틱 방식으로 나열하고, 지원되는 기능 및 컨텍스트 윈도우 크기 조정과 같은 확장된 메타데이터를 검색할 수 있습니다. 자세한 내용은 모델 가이드를 참조하세요.
메서드: models.get
버전 번호, 토큰 제한, 매개변수, 기타 메타데이터와 같은 특정 Model
에 대한 정보를 가져옵니다. 자세한 모델 정보는 Gemini 모델 가이드를 참고하세요.
엔드포인트
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> 받기
https://generativelanguage.googleapis.com/v1beta/{name=models/*}
경로 매개변수
name
string
필수 항목입니다. 모델의 리소스 이름입니다.
이 이름은 models.list
메서드에서 반환하는 모델 이름과 일치해야 합니다.
형식: models/{model}
models/{model}
형식을 사용합니다.
요청 본문
요청 본문은 비어 있어야 합니다.
요청 예시
Python
Shell
응답 본문
성공한 경우 응답 본문에 Model
의 인스턴스가 포함됩니다.
메서드: models.list
- 엔드포인트
- 쿼리 매개변수
- 요청 본문
- 응답 본문
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 승인 범위
- 요청 예시
<ph type="x-smartling-placeholder">
- </ph>
- 목록
Gemini API를 통해 사용 가능한 Model
를 나열합니다.
엔드포인트
<ph type="x-smartling-placeholder"></ph> <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
Shell
응답 본문
페이지로 나눈 모델 목록을 포함하는 ListModel
의 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
models[]
object (Model
)
반환된 모델입니다.
nextPageToken
string
다음 페이지를 검색하기 위해 pageToken
으로 전송할 수 있는 토큰입니다.
이 필드를 생략하면 더 이상 페이지가 표시되지 않습니다.
JSON 표현 |
---|
{
"models": [
{
object ( |
REST 리소스: models
- 리소스: Model
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 메서드
리소스: Model
생성형 언어 모델에 관한 정보입니다.
name
string
필수 항목입니다. Model
의 리소스 이름입니다. 허용되는 모든 값은 모델 변형을 참조하세요.
형식: 다음과 같은 {model}
이름 지정 규칙을 사용하는 models/{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 메서드 이름은 generateMessage
및 generateContent
와 같은 파스칼 표기법 문자열로 정의됩니다.
temperature
number
출력의 무작위성을 제어합니다.
값의 범위는 [0.0,maxTemperature]
(양 끝값 포함)입니다. 값이 클수록 더 다양한 응답이 생성되는 반면, 0.0
에 가까울수록 일반적으로 모델에서 예상치 못한 응답을 얻게 됩니다. 이 값은 모델을 호출하는 동안 백엔드에서 사용할 기본값을 지정합니다.
maxTemperature
number
이 모델이 사용할 수 있는 최고 온도입니다.
topP
number
핵 샘플링에서는 확률의 합이 topP
이상인 가장 작은 토큰 집합을 고려합니다. 이 값은 모델을 호출하는 동안 백엔드에서 사용할 기본값을 지정합니다.
topK
integer
Top-k 샘플링.
Top-k 샘플링은 확률이 가장 높은 topK
토큰 집합을 고려합니다. 이 값은 모델을 호출하는 동안 백엔드에서 사용할 기본값을 지정합니다. 비어 있으면 모델이 최상위 k 샘플링을 사용하지 않으며 topK
이 생성 매개변수로 허용되지 않음을 나타냅니다.
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 } |