xAI (Grok)

OpenAI-compatible chat completions.

LLM_CHAIN=xai,anthropic   # failover to a second endpoint is one more name
LLM_XAI_API_KEY=xai-…
LLM_XAI_MODEL=grok-4

Every endpoint takes the same knobs: LLM_<NAME>_TEMPERATURE (none omits it), LLM_<NAME>_BODY (JSON merged into every request), LLM_<NAME>_PRICE (input,cached,output per million, for the cost ledger), LLM_<NAME>_NOTES (a per-model notes file). Two models of one provider: LLM_FAST_PRESET=xai under another name. Environment has the full list.

Check it: npm run gateway, then curl localhost:8787/api/health — the llm.chain entry shows the endpoint, whether its key is set, and its state.

Provider docs: https://docs.x.ai

---

Source: docs/providers/xai.md — edit it there; the site mirrors the repository.