Skip to main content
Read through this guide to set up xAI’s Grok API & get familiar with how it is used across the different apps.

​
Set up Grok API

First, create an account or sign in at the xAI Console. Next, navigate to the “API Keys” section and click “Create new API key”. Make sure to save your API key somewhere safe and do not share it with anyone. Once you have your API key, paste it in your .env file: 
XAI_API_KEY=your_xai_api_key

​
Available Models

Grok models are defined in the unified model registry at lib/ai/models.ts.
ModelIDFeatures
Grok 4grok-4-latest—
Grok 4.1grok-4-1—
Grok 4.1 Fast Reasoninggrok-4-1-fast-reasoningThinking/Reasoning
Grok 4.1 Fast Reasoning supports thinking/reasoning mode, allowing the model to show its chain of thought before providing a final answer.

​
Apps Using Grok

Grok is integrated through the Vercel AI SDK 6.0. Provider routing is handled by lib/ai/ai-utils.ts using customModel(), getProviderFromModelId(), and getModelInstance().

Chat

Multi-provider chat app — Grok is available as an LLM provider

Structured Output

Generate structured JSON output using Grok models

​
Structure

The codebase uses Vercel AI SDK 6.0 with a unified model registry instead of direct xAI API calls. Models are registered in lib/ai/models.ts and routing is managed through lib/ai/ai-utils.ts. The typical flow for an AI request:
  1. The user selects a model from the unified model registry
  2. The request is routed through getModelInstance() in lib/ai/ai-utils.ts
  3. The provider is determined via getProviderFromModelId()
  4. The model is instantiated with customModel()
  5. The response is streamed back to the user
  6. Results are stored in Supabase
More information on structure of the codebase can be found here:

Structure

Understand the project structure of the codebase