TokenLab

Gemini 네이티브

모델 조회

Google Gemini API 형식을 사용하여 모델 메타데이터 조회

GET
/v1beta/models/{model}

Gemini 요청을 지원하는 단일 모델의 메타데이터를 Google Gemini API 형식으로 반환합니다.

경로 파라미터

modelstringpath필수

모델 이름(예: gemini-2.5-pro, gemini-3.5-flash). 별칭도 지원됩니다.

인증

공개 모델 메타데이터 조회 엔드포인트에는 인증이 필요하지 않습니다.

응답

namestring

models/{model} 형식의 모델 리소스 이름입니다.

baseModelIdstring

요청에 사용할 모델 ID입니다. 경로에 별칭을 사용한 경우, 해당 별칭이 확인된 실제 모델을 나타냅니다.

displayNamestring

사람이 읽을 수 있는 모델 이름입니다.

inputTokenLimitinteger

최대 입력 토큰 수(컨텍스트 윈도우)입니다. 알 수 없는 경우 생략됩니다.

outputTokenLimitinteger

최대 출력 토큰 수입니다. 알 수 없는 경우 생략됩니다.

supportedGenerationMethodsarray

이 모델에서 호출할 수 있는 작업은 generateContent, streamGenerateContent, countTokens입니다. Gemini 요청을 지원하는 임베딩 모델의 경우 대신 embedContent 및 batchEmbedContents가 나열됩니다.

versionstring

모델 버전입니다. 기본값은 모델 ID입니다.

descriptionstring

제공되는 경우, 사람이 읽을 수 있는 모델 설명입니다.

temperaturenumber

모델에서 제공하는 기본 temperature 값입니다.

topPnumber

제공되는 경우, 기본 top-p 값입니다.

topKinteger

제공되는 경우, 기본 top-k 값입니다.

maxTemperaturenumber

제공되는 경우, 지원되는 최대 temperature 값입니다.

오류

  • 실수로 :generateContent 또는 :streamGenerateContent를 포함한 잘못된 GET 요청은 405 METHOD_NOT_ALLOWED를 반환합니다.
  • 알 수 없는 모델 및 Gemini 요청을 지원하지 않는 모델은 404 NOT_FOUND를 반환합니다.

요청

curl "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro"

응답

Response
{
  "name": "models/gemini-2.5-pro",
  "baseModelId": "gemini-2.5-pro",
  "version": "gemini-2.5-pro",
  "displayName": "Gemini 2.5 Pro",
  "description": "gemini-2.5-pro model available via TokenLab",
  "inputTokenLimit": 1048576,
  "outputTokenLimit": 65536,
  "supportedGenerationMethods": [
    "generateContent",
    "streamGenerateContent",
    "countTokens"
  ]
}

경로 매개변수

model*string

모델 이름 또는 별칭(예: gemini-2.5-pro)

응답

application/json

application/json

application/json

application/json