X API・Grok API・Grok Botの違いとWebhookで頼む手順

公開 更新 著者 永上裕之仕事の自動化
ユニコ着ぐるみが、Grok BotにWebhookで外から仕事を頼めると指さしているイメージ

この記事の要点

  • X API・Grok API・Grok Botは、どれも別の請求・別の管理画面。X APIとGrok APIは前払いの従量、Grok Botは月額サブスク
  • Grok Botのルーチンには Webhook のきっかけを付けられる。送り先URLと鍵がルーチンの画面に出る
  • 鍵をAuthorizationヘッダーに入れてJSONをPOSTすると、本文がルーチンの指示と一緒にボットへ渡る。200は受付だけで、結果はボットのチャットに出る

活用例:毎朝の集計スクリプトの結果を、Grok Botのルーチンに渡してまとめと共有を任せる

部署
マーケティング・情報システム
使うもの
Grok Botのルーチン・Webhook・自分のスクリプト
AIに任せる
届いたデータの読み取り・まとめ・決めた場所への共有
人が決める
何を頼むか・承認が要る操作の線引き・鍵の管理

「X のAPI」「Grok のAPI」「Grok Bot」は、名前が似ているので同じ財布だと思われがちです。実際は3つとも請求も管理画面も別で、片方の残高やサブスクがもう片方に使えるとは、公式には書かれていません。

この記事は、xAI と X の公式ページ(2026年11月19日確認)にもとづいて、まず3つの違いを整理し、次に Grok Bot のルーチンへ外のスクリプトから Webhook で仕事を頼む設定と仕組みを手順の形でまとめます。Grok Bot そのものの紹介は Grok Botとは をご覧ください。

結論:3つは「何に払うか」がまったく違う

X API はX の投稿を読む・書く道具、Grok API はGrok のモデルを呼ぶ道具、Grok Bot は仕事を任せるボットのサブスクです。似ているのは名前だけで、払い方も上限の考え方も別物です。

X API・Grok API・Grok Botの3つに別々の財布がある図
X API・Grok API・Grok Botの3つに別々の財布がある図(イメージ)
項目X APIGrok API(xAI API)Grok Bot
何に使うかX の投稿の読み取り・投稿Grok のモデル・検索ツールを自分のプログラムから呼ぶボットに仕事を任せる(自分のコンピューター・ツールへのサインイン・ルーチン)
払い方前払いのクレジットから従量で引かれる。サブスクなし前払いのクレジットから従量で引かれる月額(Premium 30ドル/Super 100ドル/Ultra 200ドル)
管理する画面X の開発者コンソールxAI のコンソールGrok Bot のアプリ
残高が尽きると追加するまでリクエストが止まる既定ではリクエストが拒否される週の利用量を超えた分はトークン代で請求

料金の数字を公式で確かめる

数字はどれも従量なので、何回呼ぶか・何件返るかで決まります。公式ページの値は次のとおりです(変わることがあるので、使う前に各コンソールで確認してください)。

X API

出典:https://docs.x.com/x-api/getting-started/pricing

Grok API(xAI API)

出典:https://docs.x.ai/docs/key-information/billing / https://docs.x.ai/developers/pricing

Grok Bot

出典:https://x.ai/bot

サブスクにAPIクレジットは含まれる?

xAI の請求のページは、APIの前払いクレジットについてだけ説明しています。Grok のサブスクや Grok Bot の月額に API のクレジットが含まれるかどうかは、公式に記載なしです。別々に用意する前提で予算を組むのが安全です。

Grok Botを外から呼ぶ方法は Webhook

Grok Bot は、ボット側から外のアプリや MCP サーバーを使えます。一方で、Grok Bot そのものを外から MCP サーバーや API として呼ぶ方法は、公式に記載なしです。外のスクリプトから仕事を頼む公式の入口は、ルーチンの Webhook です。

ルーチンは「決まった仕事を決まったきっかけで動かす」仕組みで、きっかけは次から選べます。

作ったばかりのルーチンは、すぐには動きません。次のきっかけを待ちます。

手順:Webhook のきっかけを付けて呼ぶまで

流れは4段です。自分のスクリプトが送る → ボットが受け取ってこなす → 結果がボットのチャットに出る → 人がそれを確かめて使う、の順に進みます。

外のスクリプトからGrok Botへ、受付・実行・結果・受け取りの4段で仕事が流れる図
外のスクリプトからGrok Botへ、受付・実行・結果・受け取りの4段で仕事が流れる図(イメージ)
  1. 仕事を任せたいボットに、ルーチンを作ってもらう。何を入力にするか、何を返すか、承認が要る操作はどこまでか、材料が無い時にどうするかを一緒に伝える
  2. そのボットに「このルーチンに Webhook のきっかけを足して」と頼む
  3. デスクトップ版でルーチンを開き、Webhook の欄から 送り先URL(POST to)・鍵(key)・ヘッダー(header) の3つを控える
  4. 自分のスクリプトから、送り先URLへ HTTP の POST を送る。ヘッダーは Authorization: Bearer と鍵。本文に JSON を付けると、ボットはルーチンの指示と一緒にその中身を受け取る
  5. 応答が 200 なら受付完了。仕事が終わったという意味ではないので、結果はボットのチャットで確かめる

鍵はコードに直接書かず、環境変数から読みます。Python で書くと、たとえば次の形です。

import json, os, urllib.request

url = os.environ["GROK_BOT_WEBHOOK_URL"]
key = os.environ["GROK_BOT_WEBHOOK_KEY"]
body = json.dumps({"task": "今日の集計を3行でまとめて", "rows": 120}).encode()
req = urllib.request.Request(url, data=body, method="POST",
    headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"})
print(urllib.request.urlopen(req).status)  # 200 なら受付だけ完了

JSON の項目名に決まりは書かれていません。ボットが読むのは本文とルーチンの指示なので、項目名より「何をしてほしいか」がはっきり伝わる中身にするのがコツです。

仕組み:200 のあとに何が起きているか

200 は「Grok Bot が呼び出しを受け付けて、1回の実行を始めた」という合図です。200 以外が返ったときは、実行は始まっていません。 ルーチンが一時停止になっていないか、今の鍵を使っているかを確かめます。

気をつけること公式の説明
回数の上限全ルーチン合わせて1時間に300回、1つのルーチンは1時間に200回。超えると「Automation run rate limit exceeded」で失敗する
失敗したとき共有の上限で失敗した実行は、自動ではやり直さない。Test を押すか、Webhook を送り直す
試しに動かすTest も本番と同じ仕事をするので、利用量を使う
費用実行のたびに利用量を使う。動かないルーチンは何も使わない

スクリプト側は「送ったら終わり」にせず、200 以外なら記録を残して、人が送り直せるようにしておくと安心です。同じ依頼を自動で何度も送り直すと、回数の上限と利用量を同時に食うので、やり直しは回数を決めておきます。

つまずきやすいところ

複数のAIエージェントの役割分担の考え方は、dots・Grok Bot・Claude Codeの比較 でも比べています。

よくある質問

Grok Bot のサブスクだけで、Grok API も使えますか?

公式の請求ページには、サブスクに API のクレジットが含まれるという記載はありません。API は xAI のコンソールで前払いのクレジットを別に用意すると考えてください。

Webhook の結果を、自分のスクリプトで直接受け取れますか?

公式の説明では、Webhook への応答は受付の合否だけで、結果はボットのチャットに出ます。外の仕組みで受け取りたい場合は、ボットが使えるアプリ(Slack など)に結果を置くよう、ルーチンの指示に書いておく形になります。

何分おきまで定期実行できますか?

スケジュールのルーチンは、5分以上の間隔が必要です。もっと細かく動かしたい時は、自分の側で必要なときだけ Webhook を送る形のほうが、利用量の無駄も減ります。

出典:https://docs.x.ai/grok-bot/skills-routines-and-automations / https://docs.x.ai/grok-bot/computer-and-apps

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事