仕組み
クレジット制
Developer Console で事前にクレジットを購入します。API リクエストを行うたびにクレジットが差し引かれます。
エンドポイント別料金
エンドポイントごとに料金が異なります。最新の料金は Developer Console で確認できます。
契約・コミットメント不要
契約、サブスクリプション、最低利用額はありません。いつでも開始・停止できます。
リアルタイム追跡
Developer Console で利用状況とコストをリアルタイムにモニタリングできます。
クレジット消費の詳細
すべての料金は、取得したリソース単位(読み取り)またはリクエスト単位(書き込み/アクション)で課金されます。Developer Console でクレジットを購入できます。読み取り操作(Read operations)
レスポンスで返されたリソースごとに課金されます。書き込み操作(Write operations)
リクエストごとに課金されます。料金は変更される場合があります。最新の料金は常に Developer Console および developer.x.com の料金ページで確認できます。
Webhook イベント
X Activity API を通じて配信される Webhook イベントは、Activity API のドキュメントに記載されているものと同じイベント名を使用して、配信されたイベントごとに課金されます。課金対象イベントごとに 1 回課金され、他のリソースと同じ 24 時間 UTC ウィンドウ内で重複排除されます。Owned Reads
Owned Reads とは、自分の開発者アプリが自分自身のデータ(投稿、ブックマーク、フォロワー、いいね、リストなど)に対して行うリクエストを指します。これらのエンドポイントは $0.001 per resource($1 で 1,000 リソース)で利用できます。{id} が認証済みユーザーと一致し、かつそのユーザーが開発者アプリのオーナーである場合、以下のエンドポイントは Owned Read 料金の対象となります。
重複排除(Deduplication)
すべてのリソースは UTC の 24 時間ウィンドウ内 で重複排除されます。あるリソース(例: 投稿)をリクエストして課金された場合、同じウィンドウ内で同じリソースを再度リクエストしても追加料金は発生しません。 つまり、次のとおりです:- 同じ Post を 1 日に複数回リクエストしても、課金は 1 回分のみです
- 重複排除のウィンドウは UTC の午前 0 時にリセットされます
- これはすべての課金対象リソース(Posts、users など)に適用されます
重複排除は ソフトな保証 です。大部分のケースで機能しますが、サービス障害などの特定のエッジケースではリソースが重複排除されない場合があります。
クレジット残高
クレジット残高は Developer Console に表示されます。API リクエストを行うたびに、クレジットがリアルタイムで差し引かれます。自動チャージ(Auto-recharge)
自動チャージを有効にすると、クレジット残高を自動的に補充してサービスの中断を防げます。Developer Console で次のように設定してください:自動チャージを利用するには、デフォルトに設定された保存済みの支払い方法が必要です。Developer Console からいつでもキャンセルできるほか、サポートに連絡することもできます。
自動チャージのセーフガード(Auto-recharge safeguards)
暴走や想定外の高額請求から保護するため、自動チャージには 2 つの組み込み制限があります:- 5 分間のウィンドウにつき 1 回のチャージ。 自動チャージの発動は最大でも 5 分に 1 回までで、急激な利用増加によって複数のチャージが連続して積み重なることはありません。
- 残高がゼロまたはマイナスのときは停止。 口座残高がゼロまたはマイナスの間、自動チャージは実行されません。クレジットを手動で追加すると、自動チャージが再開されます。
支出上限(Spending limits)
請求サイクルごとに支出できる上限額を設定して、コストをコントロールできます。上限に達すると、次の請求サイクルまで API リクエストはブロックされます。無料の xAI API クレジット
X API クレジットを購入すると、請求サイクル中の累計支出額に応じて無料の xAI API クレジットを獲得できます。無料の xAI クレジットを受け取るには、xAI チームを X 開発者アカウントにリンクする必要があります。Developer Console のアカウント設定からリンクできます。
仕組み
累計支出額は各請求サイクルを通じて記録されます。支出のしきい値を超えるたびに、より高い還元率がアンロックされます。新しい請求サイクルが始まると、累計支出額は $0 にリセットされます。還元率は 累計残高全体 に適用されますが、実際に受け取るのは差分(新たに獲得すべき額からすでに付与済みの額を引いた金額)のみです。
例
請求サイクル中に複数回の購入を行ったとします:
これは、1 回で $1,000 を購入した場合に受け取る金額と同じです。購入の順序や金額の分け方によって合計の還元額が変わることはありません。
利用状況のモニタリング
Usage エンドポイント を使うと、API の利用状況をプログラムで追跡できます:- 予算に対する消費量を追跡する
- 上限が近づいたときのアラートを設定する
- 消費量の多いエンドポイントを特定する
- 利用状況レポートを作成する
次のステップ
Developer Console
クレジットの購入や最新の料金確認はこちら。
Usage API
利用状況をプログラムでモニタリングします。