작동 방식
크레딧 기반
Developer Console에서 크레딧을 미리 구매하세요. API 요청 시 크레딧이 차감됩니다.
엔드포인트별 요금
엔드포인트마다 비용이 다릅니다. 현재 요율은 Developer Console에서 확인할 수 있습니다.
약정 없음
계약, 구독, 최소 지출액이 없습니다. 언제든지 시작하고 중단할 수 있습니다.
실시간 추적
Developer Console에서 사용량과 비용을 실시간으로 모니터링하세요.
크레딧 소비 상세
모든 가격은 가져온 리소스당(읽기) 또는 요청당(쓰기/액션) 기준입니다. Developer Console에서 크레딧을 구매할 수 있습니다.읽기(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 |
가격은 변경될 수 있습니다. 최신 요율은 항상 Developer Console 및 developer.x.com 요금 페이지에서 확인할 수 있습니다.
Webhook 이벤트
X Activity API를 통해 전달되는 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 |
중복 제거(Deduplication)
모든 리소스는 24시간 UTC 일자 윈도우 내에서 중복 제거됩니다. 특정 리소스(예: Post)를 요청하고 과금된 경우, 동일한 윈도우 내에서 같은 리소스를 다시 요청해도 추가 비용이 발생하지 않습니다. 이는 다음을 의미합니다:- 동일한 Post를 하루에 여러 번 요청해도 한 번만 과금됩니다
- 중복 제거 윈도우는 UTC 자정에 초기화됩니다
- 과금 대상 모든 리소스(Posts, 사용자 등)에 적용됩니다
중복 제거는 소프트 보장(soft guarantee) 입니다. 대부분의 경우 적용되지만, 서비스 장애와 같은 특정 엣지 케이스에서는 리소스가 중복 제거되지 않을 수 있습니다.
크레딧 잔액
크레딧 잔액은 Developer Console에 표시됩니다. API 요청 시 크레딧이 실시간으로 차감됩니다.자동 충전(Auto-recharge)
자동 충전을 활성화하여 크레딧 잔액을 자동으로 충전하고 서비스 중단을 방지하세요. Developer Console에서 다음을 설정할 수 있습니다:| 설정 | 설명 |
|---|---|
| 충전 금액 | 자동 충전이 발생할 때 추가되는 금액(예: $25) |
| 트리거 임계값 | 잔액이 이 금액 미만으로 떨어지면 자동 충전이 활성화됩니다(예: $5) |
자동 충전을 사용하려면 기본 결제 수단으로 저장된 결제 방법이 필요합니다. Developer Console에서 또는 지원팀에 문의하여 언제든지 취소할 수 있습니다.
자동 충전 안전장치(Auto-recharge safeguards)
폭주하거나 예기치 않게 큰 청구로부터 보호하기 위해, 자동 충전에는 두 가지 기본 제한이 적용됩니다:- 5분 창당 1회 충전. 자동 청구는 5분에 최대 한 번만 발생할 수 있으므로, 사용량이 갑자기 급증하더라도 여러 번의 충전이 연달아 누적되지 않습니다.
- 잔액이 0이거나 마이너스이면 일시 중지. 계정 잔액이 0이거나 마이너스인 동안에는 자동 충전이 실행되지 않습니다. 자동 충전을 다시 시작하려면 크레딧을 수동으로 추가하세요.
지출 한도(Spending limits)
비용을 관리하기 위해 청구 주기당 지출 가능한 최대 금액을 설정하세요. 한도에 도달하면 다음 청구 주기까지 API 요청이 차단됩니다.| 옵션 | 설명 |
|---|---|
| 지출 한도 | 청구 주기당 최대 지출 금액을 특정 달러 금액으로 설정합니다 |
무료 xAI API 크레딧
X API 크레딧을 구매하면 청구 주기 동안의 누적 지출 금액에 따라 무료 xAI API 크레딧을 받을 수 있습니다.무료 xAI 크레딧을 받으려면 xAI 팀을 X developer 계정에 연결해야 합니다. developer console의 계정 설정에서 연결할 수 있습니다.
작동 방식
각 청구 주기 동안의 누적 지출이 추적됩니다. 지출 임계값을 넘을 때마다 더 높은 리워드 적립률이 잠금 해제됩니다. 새로운 청구 주기가 시작되면 누적 지출은 $0으로 초기화됩니다.| 누적 지출 | 적립률 |
|---|---|
| $0 – $199 | 0% |
| $200 – $499 | 10% |
| $500 – $999 | 15% |
| $1,000+ | 20% |
이 적립률은 전체 누적 잔액에 적용되지만, 실제로는 차액—새로 적립되어야 할 금액에서 이미 적립된 금액을 뺀 만큼만 받게 됩니다.
예시
청구 주기 동안 여러 번 구매했다고 가정해 봅시다:| 구매 | 적립률 | 총 적립액 | 이미 적립됨 | 받는 금액 |
|---|---|---|---|---|
| $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 |
사용량 모니터링
Usage 엔드포인트를 사용하여 API 사용량을 프로그래밍 방식으로 추적할 수 있습니다:- 예산 대비 소비량 추적
- 한도 도달 시 알림 설정
- 소비량이 높은 엔드포인트 식별
- 사용량 보고서 생성
다음 단계
Developer Console
크레딧을 구매하고 현재 요금을 확인하세요.
Usage API
사용량을 프로그래밍 방식으로 모니터링하세요.