Gemini 네이티브
모델 목록 조회
Google Gemini API 형식을 사용하여 사용 가능한 모델 목록을 조회합니다
Google Gemini API 형식으로 Gemini 요청을 수락하는 모델을 반환합니다. 각 모델의 supportedGenerationMethods는 해당 모델에서 호출할 수 있는 작업을 나열합니다.
쿼리 매개변수
pageSizeintegerquery
반환할 최대 모델 수입니다. 기본값: 50, 최댓값: 1000입니다.
pageTokenstringquery
이전 페이지에서 반환된 연속 토큰입니다. 다음 슬라이스를 가져오려면 이 값을 변경하지 않고 전달하십시오.
인증
공개 모델 카탈로그 읽기 엔드포인트에는 인증이 필요하지 않습니다.
?key= 또는 x-goog-api-key와 같은 Gemini 스타일의 인증 힌트는 여기에서 응답 계약을 변경하지 않습니다.
응답
modelsarray
모델 객체의 배열입니다. 필드에 대한 자세한 내용은 모델 조회를 참조하십시오.
nextPageTokenstring
더 많은 모델을 사용할 수 있을 때 반환됩니다. 페이지 매김을 계속하려면 이 값을 pageToken으로 전달하십시오.
오류
- 잘못된
pageToken은400 INVALID_ARGUMENT를 반환합니다. - 예상치 못한 목록 조회 실패는
500 INTERNAL을 반환합니다.
요청
curl "https://api.tokenlab.sh/v1beta/models?pageSize=2" \
-H "x-goog-api-key: sk-your-api-key"응답
{
"models": [
{
"name": "models/gemini-2.5-flash",
"baseModelId": "gemini-2.5-flash",
"version": "gemini-2.5-flash",
"displayName": "Gemini 2.5 Flash",
"description": "Fast Gemini workhorse for multimodal apps where latency and price matter",
"inputTokenLimit": 1048576,
"outputTokenLimit": 65536,
"supportedGenerationMethods": [
"generateContent",
"streamGenerateContent",
"countTokens"
]
},
{
"name": "models/gemini-2.5-flash-lite",
"baseModelId": "gemini-2.5-flash-lite",
"version": "gemini-2.5-flash-lite",
"displayName": "Gemini 2.5 Flash-Lite",
"description": "Lean Gemini 2.5 lane for cheap multimodal traffic and quick agents",
"inputTokenLimit": 1048576,
"outputTokenLimit": 65536,
"supportedGenerationMethods": [
"generateContent",
"streamGenerateContent",
"countTokens"
]
}
],
"nextPageToken": "b2Zmc2V0OjI"
}