API | Grok 4.3 API — 1M 文脈、推論オフ可

xai/grok-4.3/chat

Grok 4.3 は xAI のチャットモデルで、OpenAI 互換の呼び出しからテキストと画像を 1 つのメッセージ配列で渡せます。1,000,000 トークンを読み、最大 900,000 を返し、none を含む 5 段階の推論強度があります。

入力 $1.25出力 $2.50100 万トークンあたりキャッシュ入力 $0.20200K トークン以上のプロンプト入力 $2.50出力 $5

モデルを実行 API を見る

リクエストを送信

例は、選択中のエンドポイントの公開パラメーター定義から作っています。API キーとサンプル素材を差し替えて、ご自身のサーバーから送信してください。

SDK・連携

POSThttps://api.spicyapi.ai/v1/chat/completions

API 認証

API キーはサーバーの環境変数 SPICY_API_KEY に保存します。Bearer 認証を使用し、JSON リクエストには Content-Type: application/json を指定してください。

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-4.3/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

このモデルの入力スキーマから生成した例です。API はどのリクエストも、同じスキーマで検証します。

同じ論理リクエストには同じ Idempotency-Key を使い続けてください。通信が切れた場合は新しいキーで自動再送せず、受理済みリクエストを追跡できるよう request_id を保存します。冪等性は、過去のチャットストリームを再生するものではありません。

入力パラメーター

モデルのパラメーターは、JSON リクエスト本文の model と同じ階層に指定します。このエンドポイントでは input でラップしません。

messagesarray<object>必須

最大 256 ターン。1 つの user メッセージの中で text と image_url のパートを混ぜられます。

デフォルト値: 指定なし
制約: minItems:1
maxItems:256

messages[].rolestringオブジェクト内で必須

Role of the message author.

デフォルト値: 指定なし
使用可能な値: "system""developer""user""assistant""tool"

messages[].namestring任意

Optional name identifying the speaker within its role.

デフォルト値: 指定なし

messages[].contentstring | array | null任意

Message content, either plain text or a list of content parts.

デフォルト値: 指定なし

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "detail": {
                "enum": [
                  "auto",
                  "low",
                  "high"
                ],
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>任意

Tool calls the assistant requested in this message.

デフォルト値: 指定なし

messages[].tool_call_idstring任意

Identifier of the tool call this message answers. Required on tool messages.

デフォルト値: 指定なし

messages[].reasoning_contentstring任意

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

デフォルト値: 指定なし

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "detail": {
                      "enum": [
                        "auto",
                        "low",
                        "high"
                      ],
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobject任意

答えを人ではなくコードが読むときは、JSON オブジェクトを要求してください。

デフォルト値: 指定なし

tool_choicestring | object任意

auto / none / required、または呼ぶ関数を名指しするオブジェクト。

デフォルト値: 指定なし

parallel_tool_callsboolean任意

true か false で、既定値は true です。true ではモデルが 1 ターンで複数のツール呼び出しを要求できます。false にすると 1 ターンあたりの呼び出しは最大 1 件になり、前の結果に次の呼び出しが依存するループに向きます。料金には影響しません。

デフォルト値: true

toolsarray<object>任意

1 リクエストにつき最大 128 個の関数定義。

デフォルト値: 指定なし
制約: maxItems:128

top_pnumber任意

0.01〜1。これか temperature のどちらか一方だけを動かしてください。

デフォルト値: 1
制約: minimum:0.01
maximum:1

temperaturenumber任意

0〜2、既定 0.7。2 つのモックアップ、あるいは 2 回の実行を比べるときは 0 にします。

デフォルト値: 0.7
制約: minimum:0
maximum:2

max_tokensinteger任意

可視の返答を 900,000 で抑えます。既定の 4,096 は長い生成を警告なしに打ち切ります。推論トークンは出力として課金されますが、この上限には縛られません——このエンドポイントでの実測では、強度 high・上限 800 のリクエストが出力 18,339 トークンを記録しました。予測可能な上限が必要な場合は reasoning_effort を下げてください。強度を none にすると推論の消費は完全になくなります（実測：上限 2,000 で出力 145 トークン）。

デフォルト値: 4096
制約: minimum:1
maximum:900000

reasoning_effortstring任意

none / low / medium / high / xhigh。既定は low で、none は熟考の工程を丸ごと省きます。強度は出力トークンとして消費されます。

デフォルト値: "low"
使用可能な値: "none""low""medium""high""xhigh"

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "detail": {
                          "enum": [
                            "auto",
                            "low",
                            "high"
                          ],
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 60,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 900000,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 0.7,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "none",
        "low",
        "medium",
        "high",
        "xhigh"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "low",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 2048,
  "x-input-token-limit": 1000000,
  "additionalProperties": false
}

結果を取得

stream が false の場合、完成したチャット応答が直接返ります。choices[].message を読み取ってください。タスクのポーリングは不要です。Server-Sent Events 対応のクライアントでは stream を true にできます。

完了レスポンスの例

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "xai/grok-4.3/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

レスポンス例は構造を示すためのものです。usage はトークン数を示し、実際のトークン数と料金はリクエスト内容によって変わります。

SDK・連携

アプリ、ターミナル、AI アシスタント、ビジュアルワークフローで SpicyAPI を活用。接続ガイドを選んでください。

SDKs

TypeScript · Python · Go · PHP · Java

CLI

ターミナルコマンドと自動化スクリプト。

MCP

Claude Code · Cursor · Codex

Agent Skill

AI アシスタントで再利用できる手順。

n8n

セルフホスト版のコミュニティノードと、n8n Cloud にインポートできる HTTP Request テンプレート。

ComfyUI

ノードで組み立てる画像・動画・音声ワークフロー。

その他の連携

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

すぐ使えるワークフローを見る

これはチャットモデルなので、OpenAI のチャット API が通る場所ならどこでも動きます。クライアントはそのまま、ベース URL を差し替えて、このモデル ID を指定してください。

OpenAI 互換クライアントの向き先を変えるだけ

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/xai/grok-4.3/chat

OpenAI のチャット API に対応するツールは同じ方法で使えます。SDK、Vercel AI SDK、LangChain、aider、Cline などに対応します。MCP サーバーと spicyapi CLI は非同期のメディアタスクに対応します。ツールごとの設定は開発者ハブをご覧ください。

SillyTavern やロールプレイアプリで使う

SillyTavern、RisuAI、Agnai など OpenAI 互換の設定があるアプリに、下のベース URL と API キーを貼り付け、モデルに xai/grok-4.3/chat を選んでください。ブラウザーからの呼び出しにも対応しており、このモデルが受け付けないスライダーはエラーにならず無視されます。

Base URL: https://api.spicyapi.ai/v1
Model: xai/grok-4.3/chat

SillyTavern ガイド RisuAI・Agnai ほか SillyTavern 拡張機能

ComfyUI で使う

ComfyUI Manager か下のコマンドで SpicyAPI ノードをインストールしたら、SpicyAPI Chat ノードで xai/grok-4.3/chat を選ぶと、ComfyUI のグラフの中でこのモデルを使えます。

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

ワークフロー例セットアップガイド GitHub のソース

埋め込みパネルはこのページと同じスキーマを参照するため、API 仕様とのずれを防げます。ドキュメント内の検索対象にする場合は、/api/embed/models/ の JSON を取得して描画してください。

<iframe src="https://spicyapi.ai/embed/ja/models/grok-4-3/api?model=xai%2Fgrok-4.3%2Fchat" width="100%" height="560" loading="lazy" title="リクエスト例" style="border:1px solid rgba(0,0,0,.12)"></iframe>

パネルを開く

プレイグラウンド

リクエストを送信

API 認証

入力パラメーター

結果を取得

SDK・連携

SillyTavern やロールプレイアプリで使う

ComfyUI で使う