> ## 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.

# 가격 정보 조회

> 모델의 가격 정보를 조회합니다

## 개요

이 엔드포인트는 활성 모델에 대한 현재 공개 가격 표면을 조회할 때 사용합니다.

단일 모델의 전체 가격 상세와 구조화된 가격, 출처까지 보려면 [모델 가격 조회](/ko/api-reference/models/get-model) 를 사용하세요.

## 쿼리 파라미터

<ParamField query="provider" type="string">
  선택 사항인 공급자 필터입니다. 예: `openai`, `anthropic`, `google`.
</ParamField>

<ParamField query="tag" type="string">
  선택 사항인 모델 태그 필터입니다. 예: `chat`, `image`, `video`, `embedding`, `translation`.
</ParamField>

## 응답

<ResponseField name="object" type="string">
  항상 `pricing`입니다.
</ResponseField>

<ResponseField name="updated_at" type="string">
  응답에 포함된 최신 가격 항목의 ISO 타임스탬프입니다.
</ResponseField>

<ResponseField name="currency" type="string">
  항상 `USD`입니다.
</ResponseField>

<ResponseField name="data" type="array">
  가격 항목 배열입니다. 각 항목에는 `model`, `provider`, `is_lock_price`, `capabilities`, `aliases`, 그리고 상단의 대화형 스키마가 반환하는 공개 스칼라 또는 구조화 가격 요약 필드가 포함됩니다.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.tokenlab.sh/v1/pricing?provider=openai&tag=chat" \
    -H "Authorization: Bearer sk-your-api-key"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tokenlab.sh/v1/pricing",
      headers={"Authorization": "Bearer sk-your-api-key"},
      params={"provider": "openai", "tag": "chat"}
  )

  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.tokenlab.sh/v1/pricing?provider=openai&tag=chat',
    {
      headers: { 'Authorization': 'Bearer sk-your-api-key' }
    }
  );

  const data = await response.json();
  console.log(data);
  ```

  ```go Go theme={null}
  package main

  import (
      "encoding/json"
      "fmt"
      "net/http"
  )

  func main() {
      req, _ := http.NewRequest("GET", "https://api.tokenlab.sh/v1/pricing?provider=openai&tag=chat", nil)
      req.Header.Set("Authorization", "Bearer sk-your-api-key")

      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()

      var result map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&result)
      fmt.Println(result)
  }
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init('https://api.tokenlab.sh/v1/pricing?provider=openai&tag=chat');

  curl_setopt_array($ch, [
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => [
          'Authorization: Bearer sk-your-api-key'
      ]
  ]);

  $response = curl_exec($ch);
  curl_close($ch);

  $data = json_decode($response, true);
  print_r($data);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "pricing",
    "updated_at": "2026-04-20T00:00:00.000Z",
    "currency": "USD",
    "data": [
      {
        "model": "gpt-4o",
        "provider": "openai",
        "is_lock_price": false,
        "input_per_1m_tokens": "2.50",
        "output_per_1m_tokens": "10.00",
        "capabilities": ["chat"],
        "aliases": ["gpt-4o-latest"]
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  정확한 응답 스키마는 상단의 대화형 OpenAPI 패널을 참고하세요. 공개 가격 항목에는 `lock_price_per_request`, `has_complex_pricing`, `supported_operations`, `pricing_summary`, `pricing_provenance`가 추가로 노출될 수 있습니다.
</Note>