Skip to main content

Grok 4.3 is xAI's chat model behind an OpenAI-compatible call, taking text and image parts in one message array. It reads 1,000,000 tokens, replies up to 900,000, and offers five reasoning-effort levels including none.

Input $1.25Output $2.50per 1 million tokensCached input $0.20Prompts of 200K tokens or moreInput $2.50Output $5

Workbench

Send a request

Quickstart

Examples use the selected endpoint’s public parameter definitions. Replace the API key and example media, then send the request from your server.

SDKs & integrations
POSThttps://api.spicyapi.ai/v1/chat/completions

API authentication

Keep the API key in the server environment variable SPICY_API_KEY. Use Bearer authentication and Content-Type: application/json for JSON requests.

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'

Generated from this model’s input schema — the same one the API validates every request against.

Keep one Idempotency-Key for each logical request. After a network interruption, do not automatically resend with a new key; retain request_id to investigate the accepted request. Idempotency does not replay an earlier chat stream.

Input parameters

Place the model parameters directly in the JSON request body alongside model. This endpoint does not use an input wrapper.

messagesarray<object>Required

At most 256 turns. Content can mix text and image_url parts inside a single user message.

Default
Not specified
Constraints
minItems:1
maxItems:256
response_formatobjectOptional

Request a JSON object when the answer is read by code rather than a person.

Default
Not specified
tool_choicestring | objectOptional

auto, none, required, or an object naming the function to call.

Default
Not specified
parallel_tool_callsbooleanOptional

true or false, default true: the model may request several tool calls in one turn. Set false to get at most one call per turn, for loops where each call depends on the previous result. No effect on price.

Default
true
toolsarray<object>Optional

Up to 128 function definitions per request.

Default
Not specified
Constraints
maxItems:128
top_pnumberOptional

0.01 to 1. Move this or temperature, not both together.

Default
1
Constraints
minimum:0.01
maximum:1
temperaturenumberOptional

0 to 2, default 0.7. Use 0 when comparing two mockups or two runs.

Default
0.7
Constraints
minimum:0
maximum:2
max_tokensintegerOptional

Caps the visible reply at 900,000; the default of 4,096 truncates a long answer silently. Reasoning tokens are billed as output but are NOT bound by this cap — measured on this endpoint: effort high with the cap set to 800 produced 18,339 output tokens. Lower reasoning_effort when you need a predictable ceiling. Effort none removes reasoning spend entirely (measured: 145 output tokens with the cap at 2,000).

Default
4096
Constraints
minimum:1
maximum:900000
reasoning_effortstringOptional

none, low, medium, high or xhigh. Low is the default and none skips the deliberation pass entirely; effort is spent in output tokens.

Default
"low"
Allowed values
"none""low""medium""high""xhigh"

Read the result

With stream set to false, the request returns the completed chat response directly. Read choices[].message; no task polling is needed. Set stream to true when your client supports Server-Sent Events.

Completed response example
{
  "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
  }
}

The response example is illustrative. usage reports token counts; token counts and charges depend on your actual request.

SDKs & integrations

Use SpicyAPI in your app, terminal, AI assistant or visual workflow. Choose a setup guide below.

Use it in SillyTavern and roleplay apps

In SillyTavern, RisuAI, Agnai or any app with an OpenAI-compatible setting, paste the base URL below and your API key, then pick xai/grok-4.3/chat as the model. Browser calls are allowed, and sliders this model does not take are ignored instead of rejected.

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

Use it in ComfyUI

Install the SpicyAPI nodes from ComfyUI Manager or with the command below, then pick xai/grok-4.3/chat in the SpicyAPI Chat node to use this model inside a ComfyUI graph.

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