xAI

Runtime provider id: xai. Talks to the xAI (Grok) API.

Provider options

Field	Type	Notes
apiKey	string	Required (or set via environment).
baseURL	string	Optional. Override the API endpoint.
headers	Record<string, string>	Optional. Extra HTTP headers.
reasoning	object	Optional. See Reasoning.

Reasoning

reasoning.effort maps to xAI’s reasoning_effort (low/high; minimal -> low, medium -> high). Only reasoning models (e.g. grok-3-mini) support it. Omit to leave reasoning at the default. summary/display are not used by xAI.

Example configs

{
  "name": "xAI",
  "provider": "xai",
  "options": {
    "apiKey": "xai-..."
  }
}

{
  "name": "Grok 3",
  "provider": "xAI",
  "options": {
    "model": "grok-3"
  },
  "default": true
}

With reasoning enabled on a reasoning model:

{
  "name": "xAI Reasoning",
  "provider": "xai",
  "options": {
    "apiKey": "xai-...",
    "reasoning": { "effort": "high" }
  }
}

{
  "name": "Grok 3 Mini (thinking)",
  "provider": "xAI Reasoning",
  "options": {
    "model": "grok-3-mini"
  }
}