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

# 요금

> X API의 사용량 기반 과금 체계

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

X API는 **사용량 기반 과금 방식**을 사용합니다. 구독도 없고, 월별 한도도 없으며, 사용한 만큼만 지불하면 됩니다.

<Button href="https://console.x.com">요금 확인 및 크레딧 구매</Button>

***

<div id="how-it-works">
  ## 동작 방식
</div>

<CardGroup cols={2}>
  <Card title="크레딧 기반" icon="coins">
    개발자 콘솔에서 크레딧을 미리 구매합니다. API 요청을 보낼 때마다 크레딧이 차감됩니다.
  </Card>

  <Card title="엔드포인트별 요금" icon="code">
    엔드포인트마다 비용이 다릅니다. 현재 요금은 개발자 콘솔에서 확인할 수 있습니다.
  </Card>

  <Card title="약정 없음" icon="unlock">
    계약, 구독, 최소 사용 금액 조건이 없습니다. 언제든지 시작하고 중단할 수 있습니다.
  </Card>

  <Card title="실시간 추적" icon="gauge-high">
    개발자 콘솔에서 사용량과 비용을 실시간으로 모니터링할 수 있습니다.
  </Card>
</CardGroup>

***

<div id="deduplication">
  ## 중복 제거
</div>

모든 리소스는 **24시간 UTC 일 단위** 내에서 중복 제거됩니다. 어떤 리소스(예: 게시물)를 요청해 요금이 청구된 경우, 그 기간 안에 동일한 리소스를 다시 요청하더라도 추가 요금이 부과되지 않습니다.

이는 다음을 의미합니다:

* 같은 게시물을 하루에 여러 번 요청해도 한 번만 청구됩니다
* 중복 제거 기준 시간은 UTC 자정에 초기화됩니다
* 이는 모든 과금 대상 리소스(포스트, 사용자 등)에 적용됩니다

<Note>
  중복 제거는 \*\*소프트 보장(soft guarantee)\*\*입니다. 대부분의 경우 적용되지만, 서비스 장애와 같은 특정 엣지 케이스에서는 리소스가 중복 제거되지 않을 수 있습니다.
</Note>

***

<div id="credit-balance">
  ## 크레딧 잔액
</div>

크레딧 잔액은 개발자 콘솔에 표시됩니다. API 요청을 보내면 크레딧이 실시간으로 차감됩니다.

<Warning>
  서비스 중단을 방지하려면 크레딧 잔액을 정기적으로 확인하세요. API 액세스가 중단되지 않도록 잔액이 0이 되기 전에 크레딧을 충전하세요.

  ***참고:** 계정 크레딧 잔액이 소폭 음수가 될 수 있습니다. 이 경우, 음수 잔액을 해소할 만큼 크레딧을 추가하기 전까지 API 요청이 차단됩니다.*
</Warning>

<div id="auto-recharge">
  ### 자동 충전
</div>

자동 충전을 활성화하면 크레딧 잔액이 자동으로 충전되어 서비스 중단을 방지할 수 있습니다. 개발자 콘솔에서 다음을 설정하세요:

| Setting               | Description                              |
| :-------------------- | :--------------------------------------- |
| **Recharge amount**   | 자동 충전이 실행될 때 추가되는 금액 (예: \$25)           |
| **Trigger threshold** | 잔액이 이 금액 아래로 떨어지면 자동 충전이 활성화됩니다 (예: \$5) |

<Note>
  자동 충전을 사용하려면 기본값으로 지정된 결제 수단이 저장되어 있어야 합니다. 언제든지 개발자 콘솔에서 또는 지원팀에 문의하여 취소할 수 있습니다.
</Note>

***

<div id="spending-limits">
  ### 지출 한도
</div>

청구 주기마다 사용할 수 있는 최대 금액을 설정해 비용을 관리할 수 있습니다. 한도에 도달하면 다음 청구 주기까지 API 요청이 차단됩니다.

| Option             | Description                              |
| :----------------- | :--------------------------------------- |
| **Spending limit** | 청구 주기마다 최대 지출 금액으로 사용할 구체적인 달러 금액을 설정합니다 |

<Tip>
  특히 개발 및 테스트 중 예기치 않은 요금이 발생하지 않도록 지출 한도를 설정해 두세요.
</Tip>

***

<div id="monitoring-usage">
  ## 사용량 모니터링
</div>

[Usage endpoint](/ko/x-api/usage/introduction)를 사용해서 프로그램을 통해 API 사용량을 추적하세요.

```bash theme={null}
curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"
```

이는 일별 게시물 사용량 건수를 반환하여, 다음과 같은 작업에 도움이 됩니다:

* 예산 대비 사용량 추적
* 한도에 가까워질 때 알림 설정
* 사용량이 많은 엔드포인트 식별
* 사용량 보고서 생성

***

<div id="enterprise-pricing">
  ## 엔터프라이즈 요금제
</div>

대량 사용을 위한 액세스, 전용 지원, 맞춤형 요청 한도 및 추가 기능이 필요하다면 엔터프라이즈 영업팀에 문의하세요.

<Button href="/ko/forms/enterprise-api-interest">엔터프라이즈 영업팀 문의</Button>

***

<div id="next-steps">
  ## 다음 단계
</div>

<CardGroup cols={2}>
  <Card title="개발자 콘솔" icon="grid-2" href="https://console.x.com">
    크레딧을 구매하고 최신 요금 정보를 확인하세요.
  </Card>

  <Card title="Usage API" icon="chart-line" href="/ko/x-api/usage/introduction">
    사용량을 프로그래밍 방식으로 모니터링하세요.
  </Card>
</CardGroup>