Skip to main content
POST
Grok Responses(全モデル、完全なパラメータ)
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。
サーバーサイドツールは xAI のインフラ上で実行され、トークン消費とは別に、成功した呼び出しごとに課金されます:ウェブ検索 / X 検索 / コード実行は 1 回 0.005、添付ファイル検索は10.005、添付ファイル検索は 1 回 0.01、コレクション検索は 1 回 $0.0025。ツール料金はロングコンテキストの倍率の影響を受けません。
image_generation は現在 Grok 4.5 では利用できません:互換性のため宣言は受け付けますが、リクエストがモデルに届く前にツールは削除されます。未認識の tools[].type400 で拒否されます。

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加:

ボディ

application/json
model
enum<string>
必須

呼び出すモデル:

利用可能なオプション:
grok-4.5
:

"grok-4.5"

input
必須

モデルへの入力:単純な文字列、または OpenAI Responses の入力アイテムの配列(例:{"role":"user","content":[...]})。そのまま透過的に渡されます。

:

"Search the web for the latest SpaceX launch and summarize it in one sentence."

stream
boolean
デフォルト:false

ストリーミングでレスポンスを返すかどうか(SSE イベント。response.completed で終了)。デフォルトは false

:

false

max_output_tokens
integer

生成するトークンの最大数(推論トークンを含む)。

:

2048

tools
object[]

ツールの宣言。xAI のサーバーサイドツール(成功した呼び出しごとに課金。料金はロングコンテキストの倍率の影響を受けません):

通常の function ツール(クライアント側の関数呼び出し)にも対応し、呼び出しごとの追加料金はかかりません。

⚠️ image_generation は現在利用できません:互換性のため宣言は受け付けますが、リクエストがモデルに届く前に削除されます。未認識のツールタイプは 400 で拒否されます。

:
tool_choice

ツールの選択を制御します:"auto"(デフォルト)/ "none" / "required"、または特定のツールを指定するオブジェクト(例:{"type": "web_search"})。

利用可能なオプション:
auto,
none,
required
max_tool_calls
integer

このリクエストで許可するサーバーサイドツール呼び出しの上限。指定しない場合(または null の場合)、プラットフォームが利用可能残高に応じて最大 10 回までの上限を自動的に適用します。宣言された有料ツールは最悪ケースの予算を事前に確保し、未使用分は精算時に返還されます。

:

5

レスポンス

レスポンス生成成功(JSON オブジェクト、または stream=true の場合は response.completed で終わる SSE イベントストリーム)

id
string

レスポンスの一意の識別子

:

"55d44212-8d5e-90cc-975f-36d341ce21f5"

object
enum<string>

レスポンスタイプ

利用可能なオプション:
response
:

"response"

status
enum<string>

応答ステータス

利用可能なオプション:
completed,
incomplete,
failed
:

"completed"

model
string

実際に使用されたモデル名

:

"grok-4.5"

created_at
integer

作成タイムスタンプ

:

1786538000

output
object[]

生成順に並んだ出力アイテム:reasoning アイテム(思考の要約)、web_search_call / code_interpreter_call などのサーバーサイドツール呼び出しアイテム(ステータス completed は成功した課金対象の呼び出しを示します)、最後に output_text を含む message アイテム。

usage
object

トークンとツールの使用統計。プロンプトが 200K トークン以上の場合、すべてのトークン種別が 2 倍で課金されます。ツール料金は倍率の影響を受けません。