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

# X API 사용량 기반 요금제와 크레딧

> X API는 별도의 구독이 필요 없는 사용량 기반 요금제입니다. 크레딧 구매, 자동 충전, 월별 지출 한도 설정, 요청 중복 제거를 지원하며 사용 금액에 따라 최대 20%의 무료 xAI (Grok) 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는 **사용량 기반(pay-per-usage)** 요금제를 사용합니다. 구독 없이 사용한 만큼만 지불하세요.

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

***

## 작동 방식

<CardGroup cols={2}>
  <Card title="크레딧 기반" icon="coins">
    Developer Console에서 크레딧을 미리 구매하세요. API 요청 시 크레딧이 차감됩니다.
  </Card>

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

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

  <Card title="실시간 추적" icon="gauge-high">
    Developer Console에서 사용량과 비용을 실시간으로 모니터링하세요.
  </Card>
</CardGroup>

<Tip>
  X API 크레딧을 구매하면 지출 금액에 따라 최대 20%까지 무료 [xAI API](https://docs.x.ai) 크레딧을 받을 수 있습니다. [자세히 보기](#free-xai-api-credits)
</Tip>

***

## 크레딧 소비 상세

모든 가격은 가져온 리소스당(읽기) 또는 요청당(쓰기/액션) 기준입니다. Developer Console에서 [크레딧을 구매](https://console.x.com)할 수 있습니다.

### 읽기(Read) 작업

응답에 반환된 리소스당 과금됩니다.

| 리소스                           | 단가           |
| :---------------------------- | :----------- |
| **Posts: Read**               | 리소스당 \$0.005 |
| **User: Read**                | 리소스당 \$0.010 |
| **DM Event: Read**            | 리소스당 \$0.010 |
| **Following/Followers: Read** | 리소스당 \$0.010 |
| **List: Read**                | 리소스당 \$0.005 |
| **Space: Read**               | 리소스당 \$0.005 |
| **Community: Read**           | 리소스당 \$0.005 |
| **Note: Read**                | 리소스당 \$0.005 |
| **Like: Read**                | 리소스당 \$0.001 |
| **Mute: Read**                | 리소스당 \$0.001 |
| **Block: Read**               | 리소스당 \$0.001 |
| **Profile Update: Read**      | 리소스당 \$0.005 |

### 쓰기(Write) 작업

요청당 과금됩니다.

| 액션                           | 단가          |
| :--------------------------- | :---------- |
| **Post: Create**             | 요청당 \$0.015 |
| **Post: Create (with URL)**  | 요청당 \$0.200 |
| **Post: Create (summoned)**  | 요청당 \$0.010 |
| **DM Interaction: Create**   | 요청당 \$0.015 |
| **User Interaction: Create** | 요청당 \$0.015 |
| **Interaction: Delete**      | 요청당 \$0.010 |
| **Content: Manage**          | 요청당 \$0.005 |
| **List: Create**             | 요청당 \$0.010 |
| **List: Manage**             | 요청당 \$0.005 |
| **Bookmark**                 | 요청당 \$0.005 |
| **Media Metadata**           | 요청당 \$0.005 |
| **Privacy: Update**          | 요청당 \$0.010 |
| **Mute: Delete**             | 요청당 \$0.005 |
| **Counts: Recent**           | 요청당 \$0.005 |
| **Counts: All**              | 요청당 \$0.010 |
| **Trends**                   | 요청당 \$0.010 |

<Note>
  가격은 변경될 수 있습니다. 최신 요율은 항상 [Developer Console](https://console.x.com) 및 [developer.x.com 요금 페이지](https://developer.x.com/#pricing)에서 확인할 수 있습니다.
</Note>

### Webhook 이벤트

[X Activity API](/x-api/activity/introduction)를 통해 전달되는 Webhook 이벤트는 Activity API 문서에 표시된 것과 동일한 이벤트 이름을 사용하여 전달된 이벤트당 과금됩니다. 과금 대상 이벤트당 한 번 과금되며, 다른 리소스와 동일한 24시간 UTC 기간 내에서 중복 제거됩니다.

| 이벤트                      | 이벤트당 비용 |
| :----------------------- | :------ |
| `post.create`            | \$0.005 |
| `post.delete`            | 과금되지 않음 |
| `follow.follow`          | \$0.010 |
| `follow.unfollow`        | \$0.010 |
| `profile.update.*`       | \$0.005 |
| `chat.received`          | \$0.010 |
| `chat.sent`              | 과금되지 않음 |
| `chat.conversation_join` | 과금되지 않음 |
| `dm.received`            | \$0.010 |
| `dm.sent`                | 과금되지 않음 |
| `dm.read`                | 과금되지 않음 |
| `dm.indicate_typing`     | 과금되지 않음 |
| `news.new`               | \$0.005 |
| `spaces.start`           | \$0.005 |
| `spaces.end`             | \$0.005 |

***

## Owned Reads

Owned Reads는 본인의 developer app이 본인의 데이터(posts, bookmarks, followers, likes, lists 등)에 대해 수행하는 요청입니다. 이러한 엔드포인트의 가격은 **리소스당 \$0.001**(\$1로 리소스 1,000개)입니다.

다음 엔드포인트는 `{id}`가 인증된 사용자와 일치하고, 해당 사용자가 developer app의 소유자인 경우 Owned Read 요금이 적용됩니다.

| 엔드포인트                                | 설명              |
| :----------------------------------- | :-------------- |
| `GET /2/users/{id}/tweets`           | 본인의 posts       |
| `GET /2/users/{id}/mentions`         | 본인의 멘션          |
| `GET /2/users/{id}/liked_tweets`     | 본인이 좋아요한 posts  |
| `GET /2/users/{id}/bookmarks`        | 본인의 북마크         |
| `GET /2/users/{id}/followers`        | 본인의 팔로워         |
| `GET /2/users/{id}/following`        | 본인이 팔로우하는 계정    |
| `GET /2/users/{id}/blocking`         | 본인이 차단한 계정      |
| `GET /2/users/{id}/muting`           | 본인이 뮤트한 계정      |
| `GET /2/users/{id}/owned_lists`      | 본인이 소유한 lists   |
| `GET /2/users/{id}/followed_lists`   | 본인이 팔로우하는 lists |
| `GET /2/users/{id}/list_memberships` | 본인이 속한 lists    |
| `GET /2/users/{id}/pinned_lists`     | 본인의 고정 lists    |

<Tip>
  Owned Reads를 활용하면 대시보드 앱, 개인 분석 도구, 계정 관리 도구 등 사용자 본인의 데이터를 다루는 앱을 훨씬 저렴하게 구축할 수 있습니다.
</Tip>

***

## 중복 제거(Deduplication)

모든 리소스는 **24시간 UTC 일자 윈도우** 내에서 중복 제거됩니다. 특정 리소스(예: Post)를 요청하고 과금된 경우, 동일한 윈도우 내에서 같은 리소스를 다시 요청해도 추가 비용이 발생하지 않습니다.

이는 다음을 의미합니다:

* 동일한 Post를 하루에 여러 번 요청해도 한 번만 과금됩니다
* 중복 제거 윈도우는 UTC 자정에 초기화됩니다
* 과금 대상 모든 리소스(Posts, 사용자 등)에 적용됩니다

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

***

## 크레딧 잔액

크레딧 잔액은 Developer Console에 표시됩니다. API 요청 시 크레딧이 실시간으로 차감됩니다.

<Warning>
  서비스 중단을 방지하기 위해 크레딧 잔액을 정기적으로 모니터링하세요. 잔액이 0에 도달하기 전에 크레딧을 추가하여 중단 없는 API 액세스를 보장하세요.

  ***참고:** 계정 크레딧 잔액이 약간 마이너스가 될 수 있습니다. 이 경우 마이너스 잔액을 충당할 수 있도록 크레딧을 추가할 때까지 API 요청이 차단됩니다.*
</Warning>

### 자동 충전(Auto-recharge)

자동 충전을 활성화하여 크레딧 잔액을 자동으로 충전하고 서비스 중단을 방지하세요. Developer Console에서 다음을 설정할 수 있습니다:

| 설정          | 설명                                       |
| :---------- | :--------------------------------------- |
| **충전 금액**   | 자동 충전이 발생할 때 추가되는 금액(예: \$25)            |
| **트리거 임계값** | 잔액이 이 금액 미만으로 떨어지면 자동 충전이 활성화됩니다(예: \$5) |

<Note>
  자동 충전을 사용하려면 기본 결제 수단으로 저장된 결제 방법이 필요합니다. Developer Console에서 또는 지원팀에 문의하여 언제든지 취소할 수 있습니다.
</Note>

#### 자동 충전 안전장치(Auto-recharge safeguards)

폭주하거나 예기치 않게 큰 청구로부터 보호하기 위해, 자동 충전에는 두 가지 기본 제한이 적용됩니다:

* **5분 창당 1회 충전.** 자동 청구는 5분에 최대 한 번만 발생할 수 있으므로, 사용량이 갑자기 급증하더라도 여러 번의 충전이 연달아 누적되지 않습니다.
* **잔액이 0이거나 마이너스이면 일시 중지.** 계정 잔액이 0이거나 마이너스인 동안에는 자동 충전이 실행되지 않습니다. 자동 충전을 다시 시작하려면 크레딧을 수동으로 추가하세요.

<Warning>
  사용 패턴이 매우 폭발적이어서 한 번의 전체 충전을 5분 이내에 소진할 정도라면, 자동 충전이 켜져 있어도 "크레딧 부족" 오류가 발생할 수 있습니다. 한 번의 충전이 최대 사용량 기준 5분 창을 충분히 견딜 수 있도록 **충전 금액**을 늘리세요.
</Warning>

***

### 지출 한도(Spending limits)

비용을 관리하기 위해 청구 주기당 지출 가능한 최대 금액을 설정하세요. 한도에 도달하면 다음 청구 주기까지 API 요청이 차단됩니다.

| 옵션        | 설명                                |
| :-------- | :-------------------------------- |
| **지출 한도** | 청구 주기당 최대 지출 금액을 특정 달러 금액으로 설정합니다 |

<Tip>
  특히 개발 및 테스트 단계에서 예기치 않은 비용을 방지하기 위해 지출 한도를 활용하세요.
</Tip>

***

## 무료 xAI API 크레딧

X API 크레딧을 구매하면 청구 주기 동안의 누적 지출 금액에 따라 무료 [xAI API](https://docs.x.ai) 크레딧을 받을 수 있습니다.

<Note>
  무료 xAI 크레딧을 받으려면 xAI 팀을 X developer 계정에 연결해야 합니다. [developer console](https://console.x.com)의 계정 설정에서 연결할 수 있습니다.
</Note>

### 작동 방식

각 청구 주기 동안의 누적 지출이 추적됩니다. 지출 임계값을 넘을 때마다 더 높은 리워드 적립률이 잠금 해제됩니다. 새로운 청구 주기가 시작되면 누적 지출은 \$0으로 초기화됩니다.

| 누적 지출         | 적립률 |
| :------------ | :-- |
| \$0 – \$199   | 0%  |
| \$200 – \$499 | 10% |
| \$500 – \$999 | 15% |
| \$1,000+      | 20% |

<Note>
  이 적립률은 **전체 누적 잔액**에 적용되지만, 실제로는 차액—새로 적립되어야 할 금액에서 이미 적립된 금액을 뺀 만큼만 받게 됩니다.
</Note>

### 예시

청구 주기 동안 여러 번 구매했다고 가정해 봅시다:

| 구매          | 적립률 | 총 적립액    | 이미 적립됨   | 받는 금액       |
| :---------- | :-- | :------- | :------- | :---------- |
| \$100       | 0%  | \$0      | \$0      | **\$0**     |
| \$100       | 10% | \$20     | \$0      | **\$20**    |
| \$150       | 10% | \$35     | \$20     | **\$15**    |
| \$150       | 15% | \$75     | \$35     | **\$40**    |
| \$250       | 15% | \$112.50 | \$75     | **\$37.50** |
| \$250       | 20% | \$200    | \$112.50 | **\$87.50** |
|             |     |          |          |             |
| **\$1,000** |     |          |          | **\$200**   |

이는 \$1,000을 한 번에 구매했을 때 받는 금액과 동일합니다. 구매 순서와 규모는 총 리워드에 영향을 미치지 않습니다.

<Tip>
  [console.x.ai](https://console.x.ai)에서 xAI 크레딧 잔액을 확인하고 계정을 관리할 수 있습니다. xAI API 청구에 대한 자세한 내용은 [xAI 청구 문서](https://docs.x.ai/docs/key-information/billing)를 참조하세요.
</Tip>

***

## 사용량 모니터링

[Usage 엔드포인트](/x-api/usage/introduction)를 사용하여 API 사용량을 프로그래밍 방식으로 추적할 수 있습니다:

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

이는 일일 Post 소비량을 반환하여 다음과 같은 작업에 도움이 됩니다:

* 예산 대비 소비량 추적
* 한도 도달 시 알림 설정
* 소비량이 높은 엔드포인트 식별
* 사용량 보고서 생성

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="Developer Console" icon="grid-2" href="https://console.x.com">
    크레딧을 구매하고 현재 요금을 확인하세요.
  </Card>

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