仕組み
クレジット制
Developer Console で事前にクレジットを購入します。API リクエストを行うたびにクレジットが差し引かれます。
エンドポイント別料金
エンドポイントごとに料金が異なります。最新の料金は Developer Console で確認できます。
契約・コミットメント不要
契約、サブスクリプション、最低利用額はありません。いつでも開始・停止できます。
リアルタイム追跡
Developer Console で利用状況とコストをリアルタイムにモニタリングできます。
クレジット消費の詳細
すべての料金は、取得したリソース単位(読み取り)またはリクエスト単位(書き込み/アクション)で課金されます。Developer Console でクレジットを購入できます。読み取り操作(Read operations)
レスポンスで返されたリソースごとに課金されます。| リソース | 単価 |
|---|---|
| Posts: Read | $0.005 per resource |
| User: Read | $0.010 per resource |
| DM Event: Read | $0.010 per resource |
| Following/Followers: Read | $0.010 per resource |
| List: Read | $0.005 per resource |
| Space: Read | $0.005 per resource |
| Community: Read | $0.005 per resource |
| Note: Read | $0.005 per resource |
| Media: Read | $0.005 per resource |
| Analytics: Read | $0.005 per resource |
| Trend: Read | $0.010 per resource |
書き込み操作(Write operations)
リクエストごとに課金されます。| アクション | 単価 |
|---|---|
| Content: Create | $0.015 per request |
| Content: Create (with URL) | $0.200 per request |
| DM Interaction: Create | $0.015 per request |
| User Interaction: Create | $0.015 per request |
| Interaction: Delete | $0.010 per request |
| Content: Manage | $0.005 per request |
| List: Create | $0.010 per request |
| List: Manage | $0.005 per request |
| Bookmark | $0.005 per request |
| Media Metadata | $0.005 per request |
| Privacy: Update | $0.010 per request |
| Mute: Delete | $0.005 per request |
| Counts: Recent | $0.005 per request |
| Counts: All | $0.010 per request |
料金は変更される場合があります。最新の料金は常に Developer Console および developer.x.com の料金ページで確認できます。
Owned Reads
Owned Reads とは、自分の開発者アプリが自分自身のデータ(投稿、ブックマーク、フォロワー、いいね、リストなど)に対して行うリクエストを指します。これらのエンドポイントは $0.001 per resource($1 で 1,000 リソース)で利用できます。{id} が認証済みユーザーと一致し、かつそのユーザーが開発者アプリのオーナーである場合、以下のエンドポイントは Owned Read 料金の対象となります。
| エンドポイント | 説明 |
|---|---|
GET /2/users/{id}/tweets | 自分の投稿 |
GET /2/users/{id}/mentions | 自分宛てのメンション |
GET /2/users/{id}/liked_tweets | 自分がいいねした投稿 |
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 | 自分が所有するリスト |
GET /2/users/{id}/followed_lists | 自分がフォローしているリスト |
GET /2/users/{id}/list_memberships | 自分が所属しているリスト |
GET /2/users/{id}/pinned_lists | 自分がピン留めしたリスト |
重複排除(Deduplication)
すべてのリソースは UTC の 24 時間ウィンドウ内 で重複排除されます。あるリソース(例: 投稿)をリクエストして課金された場合、同じウィンドウ内で同じリソースを再度リクエストしても追加料金は発生しません。 つまり、次のとおりです:- 同じ Post を 1 日に複数回リクエストしても、課金は 1 回分のみです
- 重複排除のウィンドウは UTC の午前 0 時にリセットされます
- これはすべての課金対象リソース(Posts、users など)に適用されます
重複排除は ソフトな保証 です。大部分のケースで機能しますが、サービス障害などの特定のエッジケースではリソースが重複排除されない場合があります。
クレジット残高
クレジット残高は Developer Console に表示されます。API リクエストを行うたびに、クレジットがリアルタイムで差し引かれます。自動チャージ(Auto-recharge)
自動チャージを有効にすると、クレジット残高を自動的に補充してサービスの中断を防げます。Developer Console で次のように設定してください:| 設定 | 説明 |
|---|---|
| チャージ金額(Recharge amount) | 自動チャージが発動したときに追加される金額(例: $25) |
| 発動しきい値(Trigger threshold) | 残高がこの金額を下回ると自動チャージが発動します(例: $5) |
自動チャージを利用するには、デフォルトに設定された保存済みの支払い方法が必要です。Developer Console からいつでもキャンセルできるほか、サポートに連絡することもできます。
支出上限(Spending limits)
請求サイクルごとに支出できる上限額を設定して、コストをコントロールできます。上限に達すると、次の請求サイクルまで API リクエストはブロックされます。| オプション | 説明 |
|---|---|
| 支出上限(Spending limit) | 請求サイクルあたりの最大支出額を具体的なドル金額で設定します |
無料の xAI API クレジット
X API クレジットを購入すると、請求サイクル中の累計支出額に応じて無料の xAI API クレジットを獲得できます。無料の xAI クレジットを受け取るには、xAI チームを X 開発者アカウントにリンクする必要があります。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
利用状況をプログラムでモニタリングします。