> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# 모델 정보 가져오기

> Google Gemini API 형식을 사용하여 모델 메타데이터를 가져옵니다.

Google Gemini API 형식으로 특정 모델의 메타데이터를 반환합니다.

## 경로 파라미터

<ParamField path="model" type="string" required>
  모델 이름 (예: `gemini-2.5-pro`, `gemini-3.5-flash`). 별칭도 허용됩니다.
</ParamField>

## 인증

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

## 응답

<ResponseField name="name" type="string">
  `models/{model}` 형식의 모델 리소스 이름입니다.
</ResponseField>

<ResponseField name="displayName" type="string">
  사람이 읽기 쉬운 모델 이름입니다.
</ResponseField>

<ResponseField name="inputTokenLimit" type="integer">
  최대 입력 토큰 수(컨텍스트 창)입니다.
</ResponseField>

<ResponseField name="outputTokenLimit" type="integer">
  최대 출력 토큰 수입니다.
</ResponseField>

<ResponseField name="supportedGenerationMethods" type="array">
  지원되는 생성 메서드 목록입니다. 예: `generateContent`, `countTokens`, `embedContent`.
</ResponseField>

<ResponseField name="version" type="string">
  제공되는 경우 공개 버전 문자열입니다.
</ResponseField>

<ResponseField name="description" type="string">
  제공되는 경우 사람이 읽을 수 있는 모델 설명입니다.
</ResponseField>

<ResponseField name="temperature" type="number">
  상위 시스템이 노출하는 경우의 기본 temperature입니다.
</ResponseField>

<ResponseField name="topP" type="number">
  제공되는 경우의 기본 top-p 값입니다.
</ResponseField>

<ResponseField name="topK" type="integer">
  제공되는 경우의 기본 top-k 값입니다.
</ResponseField>

<ResponseField name="maxTemperature" type="number">
  제공되는 경우의 최대 지원 temperature입니다.
</ResponseField>

## 오류

* `:generateContent` 또는 `:streamGenerateContent` 를 실수로 포함한 잘못된 GET 요청은 `405 METHOD_NOT_ALLOWED` 를 반환합니다.
* 누락된 모델은 `404 NOT_FOUND` 를 반환합니다.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro"
  ```

  ```python Python theme={null}
  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}")
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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
  }
  ```
</ResponseExample>