Text
Grok 4.7
Grok 4.7 をネイティブの Chat Completions、Responses、Messages 形式で呼び出す方法と、パラメーター、ストリーミング、使用量、現在の制限を説明します。
grok-4.7 は、以下の3つの形式で利用できます。認証には SeedRouter API キー を使用します。モデルページには Playground と現在のトークン料金があり、料金ガイドではキャッシュ済み入力と推論の計算方法を説明しています。
クイックスタート
curl https://api.seedrouter.ai/v1/responses \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.7","input":"What is 2 + 2?","reasoning":{"effort":"low"},"max_output_tokens":64,"store":false}'JSON レスポンスには output の各項目と usage が含まれます。会話履歴を構築するときは、推論やツールの項目も含め、すべての出力項目を保持してください。
リクエスト形式
| 形式 | エンドポイント | 必須フィールド |
|---|---|---|
| Responses | POST /v1/responses | model, input |
| Chat Completions | POST /v1/chat/completions | model, messages |
| Messages | POST /v1/messages | model, messages, max_tokens |
Content-Type: application/json と Authorization: Bearer $SEEDROUTER_API_KEY を使用します。Messages クライアントは anthropic-version: 2023-06-01 も送信できます。
パラメーターと制約
OpenAPI 仕様に、ネストされたリクエストとレスポンスの完全なスキーマがあります。以下の表は、対応するすべてのトップレベルのリクエストフィールドを示します。不明なフィールドと、このモデルが公式に無視するとされているパラメーターは破棄されます。対応するパラメーターでも、値が無効なら有効にはなりません。
省略可能で null を許可するフィールドには、明示的な null を指定できます。フィールドを省略すると API のデフォルト値が使われます。Playground は user を非表示にし、model を grok-4.7 に固定します。API クライアントでは引き続き user を送信できます。
- コンテキスト：会話と出力を合わせて 500,000 トークンです。
- 推論強度：
low、medium、high、xhigh。デフォルトはhighです。 max_completion_tokensとmax_output_tokensのデフォルトは、128,000 の可視出力トークンです。推論と関数呼び出しのトークンは、この可視出力の上限に含まれません。これはデフォルト値であり、最大出力能力を示すものではありません。- 出力上限は正の整数である必要があります。API は既存の整数の安全上限 1,073,741,823 も適用します。コンテキスト容量の制約は引き続き適用されます。
temperature：0 以上 2 以下、デフォルトは 1。top_p：0 より大きく 1 以下、デフォルトは 1。Responses のmin_p：0 以上 1 以下。top_k：1 以上の整数です。- ツール定義は最大 350 個です。
stream_optionsにはstream: trueが必要です。 instructionsとprevious_response_idは併用できません。推論の要約は常に詳細モードです。
Responses のパラメーター
| フィールド | 型 | 規則 |
|---|---|---|
include | 配列または null | レスポンスに追加するフィールドの配列です。 |
input（必須） | オブジェクトまたは別の対応する型 | テキスト文字列、または完全な入力項目の配列です。 |
instructions | 文字列または null | システム指示です。previous_response_id と併用できません。 |
max_output_tokens | 整数または null | 可視出力の上限です。デフォルトは 128,000。 |
max_turns | 整数または null | エージェントの最大ターン数を整数で指定します。 |
min_p | 数値または null | 0 以上 1 以下の数値です。 |
model（必須） | 文字列 | grok-4.7 に固定します。 |
parallel_tool_calls | 真偽値または null | 真偽値です。デフォルトは true。 |
previous_response_id | 文字列または null | レスポンス ID の文字列です。現在、ID による継続は利用できません。 |
prompt_cache_key | 文字列または null | キャッシュキーの文字列です。 |
reasoning | オブジェクト | 推論設定です。強度のデフォルトは high。 |
reasoning_effort | 文字列または null | low、medium、high、xhigh。デフォルトは high。 |
safety_identifier | 文字列または null | 呼び出し元が指定する任意の安全識別子です。 |
search_parameters | オブジェクト | 検索設定です。 |
service_tier | 文字列 | auto、default、priority、fast。priority と fast はトークン単価が2倍です。 |
store | 真偽値または null | 真偽値です。デフォルトは true。保存済みレスポンスの操作は現在利用できません。 |
stream | 真偽値または null | 真偽値です。デフォルトは false。 |
temperature | 数値または null | 0 以上 2 以下の数値です。デフォルトは 1。 |
text | オブジェクト | format を含むテキストレスポンス設定です。 |
tool_choice | オブジェクトまたは別の対応する型 | 自動、無効、呼び出し必須、または指定ツールです。構文は形式によって異なります。 |
tools | 配列または null | ツール定義です。最大 350 個。 |
top_k | 整数または null | 整数です。Responses では 1 以上が必要です。 |
top_p | 数値または null | 0 より大きく 1 以下の数値です。デフォルトは 1。 |
user | 文字列または null | 呼び出し元が指定する任意の識別子です。Playground では非表示です。 |
Chat Completions のパラメーター
| フィールド | 型 | 規則 |
|---|---|---|
deferred | 真偽値または null | 真偽値です。デフォルトは false。遅延完了は現在利用できません。 |
max_completion_tokens | 整数または null | 可視出力の上限です。デフォルトは 128,000。 |
max_tokens | 整数または null | 正の可視出力上限です。Messages では必須です。 |
messages（必須） | 配列 | この形式の会話メッセージです。 |
model（必須） | 文字列 | grok-4.7 に固定します。 |
n | 整数または null | 1 以上の整数です。デフォルトは 1。 |
parallel_tool_calls | 真偽値または null | 真偽値です。デフォルトは true。 |
prompt_cache_key | 文字列または null | キャッシュキーの文字列です。 |
reasoning_effort | 文字列または null | low、medium、high、xhigh。デフォルトは high。 |
response_format | オブジェクトまたは別の対応する型 | テキスト、JSON オブジェクト、または JSON スキーマ出力です。 |
safety_identifier | 文字列または null | 呼び出し元が指定する任意の安全識別子です。 |
search_parameters | オブジェクト | 検索設定です。 |
seed | 整数または null | 整数のサンプリングシードです。 |
service_tier | 文字列 | auto、default、priority、fast。priority と fast はトークン単価が2倍です。 |
stream | 真偽値または null | 真偽値です。デフォルトは false。 |
stream_options | オブジェクト | ストリーミングのオプションです。stream: true が必要です。 |
temperature | 数値または null | 0 以上 2 以下の数値です。デフォルトは 1。 |
tool_choice | オブジェクトまたは別の対応する型 | 自動、無効、呼び出し必須、または指定ツールです。構文は形式によって異なります。 |
tools | 配列または null | ツール定義です。最大 350 個。 |
top_p | 数値または null | 0 より大きく 1 以下の数値です。デフォルトは 1。 |
user | 文字列または null | 呼び出し元が指定する任意の識別子です。Playground では非表示です。 |
web_search_options | オブジェクト | 互換形式の検索オプションです。 |
Messages のパラメーター
| フィールド | 型 | 規則 |
|---|---|---|
max_tokens（必須） | 整数 | 正の可視出力上限です。Messages では必須です。 |
messages（必須） | 配列 | この形式の会話メッセージです。 |
metadata | オブジェクト | Messages のメタデータオブジェクトです。 |
model（必須） | 文字列 | grok-4.7 に固定します。 |
stop_sequences | 配列または null | 停止文字列の配列です。 |
stream | 真偽値または null | 真偽値です。デフォルトは false。 |
system | オブジェクトまたは別の対応する型 | システム文字列、またはコンテンツブロックです。 |
temperature | 数値または null | 0 以上 2 以下の数値です。デフォルトは 1。 |
tool_choice | オブジェクトまたは別の対応する型 | 自動、無効、呼び出し必須、または指定ツールです。構文は形式によって異なります。 |
tools | 配列または null | ツール定義です。最大 350 個。 |
top_k | 整数または null | 整数です。Responses では 1 以上が必要です。 |
top_p | 数値または null | 0 より大きく 1 以下の数値です。デフォルトは 1。 |
ストリーミング
stream を true に設定します。Chat は completion のチャンク、Responses は名前付きレスポンスイベント、Messages はメッセージとコンテンツブロックのイベントを送信します。テキストの差分だけでなく、最後の使用量イベントも読み取ってください。ツール呼び出しや推論は独立した出力項目の場合があります。履歴を保持するときは、ストリームを可視テキストだけに絞らないでください。
{
"model": "grok-4.7",
"input": "Explain a mutex in one sentence.",
"reasoning": { "effort": "low" },
"max_output_tokens": 128,
"store": false,
"stream": true
}ツールと構造化出力
選択した形式のツール定義を使用します。Chat は response_format、Responses は text.format を使用します。このモデルでは、関数、ウェブ検索、X 検索、コードインタープリター、MCP 呼び出しを実際に検証しています。Shell はクライアントで実行する呼び出しを返し、コンピューター上で自動的にコマンドを実行することはありません。完全なスキーマには他のツール型も記載されていますが、スキーマの記載だけでは特定の外部サービスが設定済みとは判断できません。
{
"model": "grok-4.7",
"input": "Use the code interpreter once to compute 13*17. Return the number.",
"tools": [{ "type": "code_interpreter" }],
"tool_choice": "required",
"max_turns": 1,
"reasoning": { "effort": "low" },
"max_output_tokens": 32,
"store": false
}ツール使用量はトークンとは別に課金されます。ウェブ検索とコードインタープリターは呼び出し回数を使います。X 検索は取得した投稿とプロフィールの件数を使い、同じ項目を繰り返し取得した分も含みます。X 検索の呼び出し回数は課金単位ではありません。usage.server_side_tool_usage_details とアカウントの使用量記録を確認してください。
使用量と料金
料金は入力の合計長によって決まります。入力が 200,000 トークン未満なら標準帯、200,000 トークン以上ならリクエスト全体に長コンテキスト帯を適用します。料金帯の選択にはキャッシュ済み入力も含めます。service_tier: "priority" と "fast" は、どちらの料金帯でもトークン単価を2倍にします。auto と default は標準サービスを選択します。ツール料金は別計算であり、このトークン倍率によって2倍にはなりません。
| 形式 | 入力の計上 | 出力の計上 |
|---|---|---|
| Responses | input_tokens には input_tokens_details.cached_tokens が含まれます | output_tokens には推論が含まれます。推論の内訳を再加算しないでください |
| Chat | prompt_tokens には prompt_tokens_details.cached_tokens が含まれます | xAI は可視の completion_tokens を個別に報告します。課金対象の出力合計は、推論を含む total_tokens - prompt_tokens です |
| Messages | input_tokens には cache_read_input_tokens が含まれません。キャッシュのフィールドを足すと入力合計になります | output_tokens は出力の合計です |
公開レスポンスには使用量のカウンターが含まれ、金額フィールドは含まれません。最終料金は使用量記録に表示されます。失敗したリクエストには課金されません。
会話履歴と現在の制限
ステートレスに会話を続けるには、以前の入力、返されたすべての出力項目、次のユーザーメッセージを、新しい input として送信します。Chat または Messages では、その形式で完全なメッセージ履歴を送信します。暗号化された推論やツールの項目が返された場合は、変更せずに保持してください。
現在のサービスでは、previous_response_id による継続、保存済みレスポンスの取得や削除、保存済み入力項目の一覧取得、Chat の遅延完了の返却はできません。作成時に store: true が受け付けられても、レスポンスの保存や取得に対応していることの証明にはなりません。これらのフィールドは公式契約と Playground に残っています。この制限は、本来の動作定義を置き換えるものではありません。
ファイル添付は、テストしたインラインテキストと PDF URL の入力では動作しませんでした。画像生成リクエストは画像ではなくテキストを返し、ツール検索はサーバー側の探索を完了しませんでした。これらの機能は利用可能と確認されていません。Collections 検索も有効な collection リソースが必要で、未検証です。
Chat は frequency_penalty、presence_penalty、logit_bias、stop、logprobs、top_logprobs を無視します。Responses は background、context_management、metadata、truncation、logprobs、top_logprobs を無視します。これらは転送されず、有効な操作項目としても提供されません。
エラー
無効なリクエストは、完了した回答ではなくエラーを返します。フィールドの値と公開エラーリファレンスを確認してください。エラーを返したリクエストには課金されません。