메인 콘텐츠로 건너뛰기
Google Gemini API 형식으로 특정 모델의 메타데이터를 반환합니다.

경로 파라미터

model
string
필수
모델 이름 (예: gemini-2.5-pro, gemini-3.5-flash). 별칭도 허용됩니다.

인증

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

응답

name
string
models/{model} 형식의 모델 리소스 이름입니다.
displayName
string
사람이 읽기 쉬운 모델 이름입니다.
inputTokenLimit
integer
최대 입력 토큰 수(컨텍스트 창)입니다.
outputTokenLimit
integer
최대 출력 토큰 수입니다.
supportedGenerationMethods
array
지원되는 생성 메서드 목록입니다. 예: generateContent, countTokens, embedContent.
version
string
제공되는 경우 공개 버전 문자열입니다.
description
string
제공되는 경우 사람이 읽을 수 있는 모델 설명입니다.
temperature
number
상위 시스템이 노출하는 경우의 기본 temperature입니다.
topP
number
제공되는 경우의 기본 top-p 값입니다.
topK
integer
제공되는 경우의 기본 top-k 값입니다.
maxTemperature
number
제공되는 경우의 최대 지원 temperature입니다.

오류

  • :generateContent 또는 :streamGenerateContent 를 실수로 포함한 잘못된 GET 요청은 405 METHOD_NOT_ALLOWED 를 반환합니다.
  • 누락된 모델은 404 NOT_FOUND 를 반환합니다.
curl "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro"
import google.generativeai as genai

genai.configure(
    api_key="sk-your-api-key",
    transport="rest",
    client_options={"api_endpoint": "api.tokenlab.sh"}
)

model = genai.get_model("models/gemini-2.5-pro")
print(f"Name: {model.name}")
print(f"Input limit: {model.input_token_limit}")
print(f"Output limit: {model.output_token_limit}")
{
  "name": "models/gemini-2.5-pro",
  "version": "1.0",
  "displayName": "gemini-2.5-pro",
  "description": "gemini-2.5-pro model available via TokenLab",
  "inputTokenLimit": 1048576,
  "outputTokenLimit": 65536,
  "supportedGenerationMethods": ["generateContent", "countTokens"],
  "temperature": 1.0,
  "topP": 0.95,
  "topK": 40,
  "maxTemperature": 2.0
}