작동 방식
크레딧 기반
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 |
| Media: Read | 리소스당 $0.005 |
| Analytics: Read | 리소스당 $0.005 |
| Trend: Read | 리소스당 $0.010 |
쓰기(Write) 작업
요청당 과금됩니다.| 액션 | 단가 |
|---|---|
| Content: Create | 요청당 $0.015 |
| Content: Create (with URL) | 요청당 $0.200 |
| 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 |
가격은 변경될 수 있습니다. 최신 요율은 항상 Developer Console 및 developer.x.com 요금 페이지에서 확인할 수 있습니다.
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에서 또는 지원팀에 문의하여 언제든지 취소할 수 있습니다.
지출 한도(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
사용량을 프로그래밍 방식으로 모니터링하세요.