> ## Documentation Index > Fetch the complete documentation index at: https://x-preview-mintlify-066e8699.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
; }; X API は **従量課金制** を採用しています。サブスクリプションはなく、使った分だけお支払いいただきます。 *** ## 仕組み Developer Console で事前にクレジットを購入します。API リクエストを行うたびにクレジットが差し引かれます。 エンドポイントごとに料金が異なります。最新の料金は Developer Console で確認できます。 契約、サブスクリプション、最低利用額はありません。いつでも開始・停止できます。 Developer Console で利用状況とコストをリアルタイムにモニタリングできます。 X API クレジットを購入すると、利用金額に応じて最大 20% 分の無料 [xAI API](https://docs.x.ai) クレジットを獲得できます。[詳細はこちら](#free-xai-api-credits) *** ## クレジット消費の詳細 すべての料金は、取得したリソース単位(読み取り)またはリクエスト単位(書き込み/アクション)で課金されます。Developer Console で[クレジットを購入](https://console.x.com)できます。 ### 読み取り操作(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 | | **Like: Read** | \$0.001 per resource | | **Mute: Read** | \$0.001 per resource | | **Block: Read** | \$0.001 per resource | | **Profile Update: Read** | \$0.005 per resource | ### 書き込み操作(Write operations) リクエストごとに課金されます。 | アクション | 単価 | | :--------------------------- | :------------------ | | **Post: Create** | \$0.015 per request | | **Post: Create (with URL)** | \$0.200 per request | | **Post: Create (summoned)** | \$0.010 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 | | **Trends** | \$0.010 per request | 料金は変更される場合があります。最新の料金は常に [Developer Console](https://console.x.com) および [developer.x.com の料金ページ](https://developer.x.com/#pricing)で確認できます。 ### Webhook イベント [X Activity API](/x-api/activity/introduction) を通じて配信される Webhook イベントは、Activity API のドキュメントに記載されているものと同じイベント名を使用して、配信されたイベントごとに課金されます。課金対象イベントごとに 1 回課金され、他のリソースと同じ 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 とは、自分の開発者アプリが自分自身のデータ(投稿、ブックマーク、フォロワー、いいね、リストなど)に対して行うリクエストを指します。これらのエンドポイントは **\$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` | 自分がピン留めしたリスト | Owned Reads を活用すると、ダッシュボードアプリ、個人向け分析、アカウント管理ツールなど、ユーザー自身のデータを扱うアプリを大幅に低コストで構築できます。 *** ## 重複排除(Deduplication) すべてのリソースは **UTC の 24 時間ウィンドウ内** で重複排除されます。あるリソース(例: 投稿)をリクエストして課金された場合、同じウィンドウ内で同じリソースを再度リクエストしても追加料金は発生しません。 つまり、次のとおりです: * 同じ Post を 1 日に複数回リクエストしても、課金は 1 回分のみです * 重複排除のウィンドウは UTC の午前 0 時にリセットされます * これはすべての課金対象リソース(Posts、users など)に適用されます 重複排除は **ソフトな保証** です。大部分のケースで機能しますが、サービス障害などの特定のエッジケースではリソースが重複排除されない場合があります。 *** ## クレジット残高 クレジット残高は Developer Console に表示されます。API リクエストを行うたびに、クレジットがリアルタイムで差し引かれます。 サービスの中断を避けるため、クレジット残高を定期的に確認してください。API へのアクセスを途切れさせないよう、残高がゼロになる前にクレジットを追加してください。 ***注:** アカウントのクレジット残高がわずかにマイナスになる可能性があります。その場合、マイナス残高をカバーするためにクレジットを追加するまで、API リクエストはブロックされます。* ### 自動チャージ(Auto-recharge) 自動チャージを有効にすると、クレジット残高を自動的に補充してサービスの中断を防げます。Developer Console で次のように設定してください: | 設定 | 説明 | | :---------------------------- | :------------------------------- | | **チャージ金額(Recharge amount)** | 自動チャージが発動したときに追加される金額(例: \$25) | | **発動しきい値(Trigger threshold)** | 残高がこの金額を下回ると自動チャージが発動します(例: \$5) | 自動チャージを利用するには、デフォルトに設定された保存済みの支払い方法が必要です。Developer Console からいつでもキャンセルできるほか、サポートに連絡することもできます。 #### 自動チャージのセーフガード(Auto-recharge safeguards) 暴走や想定外の高額請求から保護するため、自動チャージには 2 つの組み込み制限があります: * **5 分間のウィンドウにつき 1 回のチャージ。** 自動チャージの発動は最大でも 5 分に 1 回までで、急激な利用増加によって複数のチャージが連続して積み重なることはありません。 * **残高がゼロまたはマイナスのときは停止。** 口座残高がゼロまたはマイナスの間、自動チャージは実行されません。クレジットを手動で追加すると、自動チャージが再開されます。 利用パターンが極端にバースト的で、1 回分のチャージを 5 分以内に使い切ってしまう場合は、自動チャージを有効にしていても「クレジット不足」エラーが発生することがあります。1 回のチャージがピーク時の 5 分間のウィンドウを十分にカバーできるよう、**チャージ金額(Recharge amount)** を引き上げてください。 *** ### 支出上限(Spending limits) 請求サイクルごとに支出できる上限額を設定して、コストをコントロールできます。上限に達すると、次の請求サイクルまで API リクエストはブロックされます。 | オプション | 説明 | | :----------------------- | :----------------------------- | | **支出上限(Spending limit)** | 請求サイクルあたりの最大支出額を具体的なドル金額で設定します | 特に開発時やテスト時の予期せぬ請求を防ぐために、支出上限を活用しましょう。 *** ## 無料の xAI API クレジット X API クレジットを購入すると、請求サイクル中の累計支出額に応じて無料の [xAI API](https://docs.x.ai) クレジットを獲得できます。 無料の xAI クレジットを受け取るには、xAI チームを X 開発者アカウントにリンクする必要があります。[Developer Console](https://console.x.com) のアカウント設定からリンクできます。 ### 仕組み 累計支出額は各請求サイクルを通じて記録されます。支出のしきい値を超えるたびに、より高い還元率がアンロックされます。新しい請求サイクルが始まると、累計支出額は \$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** | これは、1 回で \$1,000 を購入した場合に受け取る金額と同じです。購入の順序や金額の分け方によって合計の還元額が変わることはありません。 xAI クレジット残高の確認やアカウント管理は [console.x.ai](https://console.x.ai) で行えます。xAI API の請求の詳細については、[xAI 請求ドキュメント](https://docs.x.ai/docs/key-information/billing)を参照してください。 *** ## 利用状況のモニタリング [Usage エンドポイント](/x-api/usage/introduction) を使うと、API の利用状況をプログラムで追跡できます: ```bash theme={null} curl "https://api.x.com/2/usage/tweets" \ -H "Authorization: Bearer $BEARER_TOKEN" ``` これにより日次の Post 消費数が返され、次のような用途に活用できます: * 予算に対する消費量を追跡する * 上限が近づいたときのアラートを設定する * 消費量の多いエンドポイントを特定する * 利用状況レポートを作成する *** ## 次のステップ クレジットの購入や最新の料金確認はこちら。 利用状況をプログラムでモニタリングします。