Grok family

xAI’s Grok models, including the reasoning models Grok 4.7, 4.6, 4.5, and 4.3, and the non-reasoning models Grok 4.1 Fast and 4.20. Called through the OpenAI-compatible API.

Common tasks

Models

For the full model list and live prices, see the models page . Model IDs have the prefix x-ai/, which can be omitted.

Endpoint support

Grok models are provided by xAI directly (grok), and some models also have Azure AI Foundry as a provider.

Examples

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="x-ai/grok-4.7",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "Explain idempotency in one sentence."}],
)
print(resp.choices[0].message.content)
print("Reasoning tokens:", resp.usage.completion_tokens_details.reasoning_tokens)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "x-ai/grok-4.7",
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Explain idempotency in one sentence."}]
  }'

Reasoning

Measured on the same math problem: by default Grok 4.7 used about 15,000 reasoning tokens and took about 4 minutes; with reasoning_effort: "low", it used about 4,200 tokens and took about 1 minute. Reasoning tokens are billed at the output rate, and their count is in usage.completion_tokens_details.reasoning_tokens; reasoning content is in delta.reasoning_content of the streaming response.

Other features

• Image input: supported by Grok 4.3, 4.20, and 4.1 Fast, using standard image_url content blocks; see Vision for the format.
• Structured output and tool calling: response_format supports json_schema; tool calling uses the standard tools parameter.
• Caching: repeated request prefixes are cached automatically; the hit count is in usage.prompt_tokens_details.cached_tokens.

Common errors

For other general errors, see Error handling.

Official docs

• xAI · Documentation 

FAQ