ホーム › APIのツール
Grokガイド
Grok APIのツール:Web検索・X検索・コード実行と料金
Grok APIには、モデルが自分で使えるサーバー側ツールがあります。ツールの料金は、トークン料金とは別に呼び出し回数でかかります。名前・料金・設定を整理します。
ツールの一覧と料金
| ツール | 名前 | できること | 料金 |
|---|---|---|---|
| Web検索 | web_search | Webを検索してページを閲覧 | $5/1,000回 |
| X検索 | x_search | Xの投稿・ユーザー・スレッドを検索 | $5/1,000投稿、$10/1,000プロフィール(返された件数で課金) |
| コード実行 | code_interpreter(OpenAI SDK)/code_execution(xAI SDK) | サンドボックスでPythonを実行 | $5/1,000回 |
| コレクション検索 | collections_search/file_search | アップロードした文書を検索 | $2.50/1,000回 |
| 添付検索 | attachment_search | 添付ファイルを検索 | $5/1,000回 |
| 画像生成 | — | 会話の中で画像を生成・編集 | (公式の一覧に回数料金の記載なし) |
Web検索の設定
| 設定 | 意味 |
|---|---|
allowed_domains | 検索・閲覧をこのドメインに限定(最大5つ)。excluded_domainsとは併用不可 |
excluded_domains | 指定ドメインを検索から除く(最大5つ) |
enable_image_understanding | 閲覧中の画像を解析するview_imageツールを与える。X検索を含めればX側でも有効 |
enable_image_search | 画像を検索して、Markdownで回答に埋め込む |
公式の資料で、X検索の期間指定やハンドル指定の詳細、出典(citations)の設定は、このガイドの確認範囲では読み取れませんでした。使う前にAPIリファレンスで確認してください。
X検索の投稿者・期間・画像の指定
2026年11月18日時点の公式ヘルプでは、X検索には、キーワード検索、意味に基づく検索、ユーザー検索、スレッド取得があります。投稿者を絞るallowed_x_handlesと、除くexcluded_x_handlesでは、ハンドルの先頭の@を付けずに渡す形式です。両方の配列を同一リクエストで併用することはできません。件数の上限は通常20、Vercel AI SDKでは10と説明されています。期間はfrom_dateとto_dateへYYYY-MM-DDの形式で渡す仕組みです。投稿の画像を見るenable_image_understandingと、動画を見るenable_video_understandingもあり、いずれも初期値はfalseです。検索対象の指定と、投稿に添付された画像や動画を読み取る指定は別の項目として公開されています。Responses APIではtools内のtypeにx_searchを設定する例が掲載されています。
出典:SpaceXSI(x.ai)『X Search』(2026年11月18日確認)https://docs.x.ai/developers/tools/x-search
コード実行で扱う計算とSDKごとの名前
2026年11月18日時点の公式ヘルプでは、コード実行ツールは、GrokがPythonのコードを書いて実行するための機能です。公式の用途には、数式の計算、統計、データセットの処理、シミュレーション、データ変換、コードのテストやデバッグがあります。複数段階の計算で中間値が必要なときや、数値の結果を検証するときが使用例として挙げられています。リクエストで使う名前は、xAI SDKのcode_execution、OpenAI互換Responses APIのcode_interpreter、Vercel AI SDKのxai.tools.codeExecution()という対応です。公式の例は、接続先をapi.x.ai/v1とし、tools配列へコード実行の型を渡して計算を依頼する構成です。文章の回答だけを生成する場合に対し、モデルが計算用のプログラムを実行できるようにするためのツール設定です。
出典:SpaceXSI(x.ai)『Code Execution Tool』(2026年11月18日確認)https://docs.x.ai/developers/tools/code-execution
アップロード文書を検索する前の準備
2026年11月18日時点の公式ヘルプでは、Collections検索は、事前にアップロードした文書群から、意味や文脈に基づいて関連情報を取り出すツールです。対象形式にはPDF、テキスト、CSVなどが挙げられています。公式の一連の例では、コレクションを作成し、文書をアップロードし、処理完了を確認してから検索へ進む構成です。OpenAI互換Responses APIでの名前はfile_searchで、vector_store_idsにコレクションのIDを渡し、max_num_resultsで取り出す件数を指定する例があります。xAI SDKのcollections_searchは、別名で同じ文書検索の役割を持ちます。計算が必要な文書分析では、コード実行を組み合わせて数値を処理し、出典付きの回答とツール使用情報を受け取る例もあります。検索対象の文書群は、リクエスト前に準備する資源として扱われています。
出典:SpaceXSI(x.ai)『Collections Search Tool』(2026年11月18日確認)https://docs.x.ai/developers/tools/collections-search
外部MCPサーバーへの接続設定
2026年11月18日時点の公式ヘルプでは、Remote MCP Toolsは、第三者または自分で実装したMCPサーバーへ接続し、そのツールをGrokから利用する仕組みです。tools配列では、接続先のserver_urlと識別用のserver_labelが必須です。接続方式はStreaming HTTPとSSEに対応し、任意の説明文、認証トークン、追加ヘッダーも設定項目に含まれています。allowed_toolsには利用を許すツール名を列挙し、空の場合はすべてを許す扱いです。xAI SDKでは、この項目をallowed_tool_names、追加ヘッダーをextra_headersという名前で指定する形式です。OpenAI互換Responses APIのrequire_approvalとconnector_idは対応対象外と説明されています。APIの形が似ている場合でも、接続先、認証、許可するツールの設定名と対応範囲を照合するための資料です。対応先には、xAI SDKとResponses APIに加え、Speech to Speech APIも含まれています。
出典:SpaceXSI(x.ai)『Remote MCP Tools』(2026年11月18日確認)https://docs.x.ai/developers/tools/remote-mcp
組み込みツールと独自関数の実行場所
2026年11月18日時点の公式ヘルプでは、APIのツールには、サーバー側で実行される組み込み型と、利用者が定義するFunction Callingの二種類があります。組み込み型は、渡したツール設定に従ってAPI側で実行されます。独自関数では、モデルが関数の呼び出しを要求し、利用者側がその処理を制御する構成です。質問を解析し、ツールを呼ぶか最終回答を返すかを判断し、実行結果を読み、必要に応じてさらにツールを使う流れが説明されています。ひとつの質問に対して複数の処理が発生する構造で、ツールの登録と実際の実行回数は同じ意味ではありません。
出典:SpaceXSI(x.ai)『Tools Overview』(2026年11月18日確認)https://docs.x.ai/developers/tools/overview
確認した公式資料
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。
あわせて読むページ
よくある質問
ツールを使うと費用はどうなりますか?
リクエストはトークン使用量とツール呼び出しの両方で課金されます(公式の価格ページ)。
X検索はどの単位で課金されますか?
呼び出し回数ではなく、返された投稿・プロフィールの件数です。
更新履歴
- 公式ドキュメントと照合して全面的に書き直しました。