TokenLab

Gemini 네이티브

모델 목록 조회

Google Gemini API 형식을 사용하여 사용 가능한 모델 목록을 조회합니다

GET
/v1beta/models

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"

응답

Response
{
  "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"
}

쿼리 매개변수

pageSize?integer

반환할 최대 모델 수입니다. 기본값: 50.

범위1 <= value <= 1000
기본값50
pageToken?string

이전 페이지의 연속 토큰입니다. 유효하지 않은 토큰은 400을 반환합니다.

응답

application/json

application/json

application/json