> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# xAI (Grok)

> Configure xAI Grok models in EnConvo

## Overview

xAI, founded by Elon Musk, develops the Grok family of language models. Grok models are designed to be maximally helpful with real-time knowledge and a distinctive conversational style.

## Supported Capabilities

| Capability             | Use it for                                                         |
| ---------------------- | ------------------------------------------------------------------ |
| **Grok chat models**   | Chat, reasoning, writing, coding, and agent tasks                  |
| **xAI Imagine**        | Image generation from natural language prompts                     |
| **xAI Speech-to-Text** | Transcribing speech for dictation or file workflows when available |
| **xAI video features** | Image-to-video and other media generation workflows when available |

<Note>
  xAI model availability changes over time. EnConvo filters the model list based
  on what your xAI account can access, so newer Grok models appear automatically
  when supported by your credentials and plan.
</Note>

## Setup

<Steps>
  <Step title="Get API Key">
    1. Go to [xAI Console](https://console.x.ai)
    2. Sign in or create an account
    3. Navigate to **API Keys**
    4. Create a new API key
  </Step>

  <Step title="Configure in EnConvo">
    1. Open **Settings** → **AI Provider**
    2. Select **xAI**
    3. Go to **Credentials** module
    4. Enter your API key
  </Step>

  <Step title="Select a model or feature">
    Choose your preferred Grok model, xAI Imagine image feature, or xAI
    speech-to-text option from the relevant command settings.
  </Step>
</Steps>

## Configuration

| Setting         | Description           | Default                |
| --------------- | --------------------- | ---------------------- |
| **Credentials** | API key configuration | Required               |
| **Model Name**  | Model to use          | Dynamic xAI model list |
| **Temperature** | Creativity (0-2)      | Medium (1)             |

## Image Generation With xAI Imagine

Use xAI Imagine from EnConvo's image generation commands when you want xAI to
create images from text prompts.

<Steps>
  <Step title="Configure xAI credentials">
    Add and validate your xAI credential in EnConvo settings.
  </Step>

  <Step title="Open Image Generation">
    Open the Image Generation command from SmartBar or Chat.
  </Step>

  <Step title="Choose xAI Imagine">
    Select xAI as the provider and choose the Imagine feature or model.
  </Step>

  <Step title="Generate and refine">
    Enter a prompt, generate the image, then use follow-up prompts or variations
    to refine the result.
  </Step>
</Steps>

## Speech-To-Text With xAI

When xAI speech-to-text is available for your account, you can select it in
speech recognition or transcription settings. It works best when you already
use xAI for other AI tasks and want to keep provider setup in one place.

For live dictation setup, see [Dictation](/features/dictation).

## Local Media Uploads For Video

For xAI video workflows that accept reference images or local media, EnConvo can
upload local files before sending the request to xAI. This means you can choose
a local image from your Mac for image-to-video workflows instead of manually
hosting it first.

## Validate and Use

<Steps>
  <Step title="Validate credentials">
    Click **Validate** in the xAI credential settings. If validation fails, confirm the API key is active and your xAI account has billing or credits available.
  </Step>

  <Step title="Choose model size">
    Use larger Grok models for complex work and smaller models for quick responses or cost-sensitive chat.
  </Step>

  <Step title="Run a quick prompt">
    Test with a short prompt before using Grok inside agents or longer workflows.
  </Step>
</Steps>

## Pricing

Check [xAI Pricing](https://x.ai/pricing) for current rates. Pricing and model
access may vary by account, region, and xAI plan.

## Best Practices

<AccordionGroup>
  <Accordion title="Model Selection">
    * Larger Grok models: complex reasoning, writing, coding, and analysis
    * Smaller Grok models: quick chat, simple Q\&A, and cost-sensitive workloads
  </Accordion>

  <Accordion title="Unique Strengths">
    Grok models are known for their direct, unfiltered communication style and strong performance on reasoning benchmarks. They are a solid choice for brainstorming and creative tasks.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API key">
    * Verify the key is copied correctly from [console.x.ai](https://console.x.ai)
    * Check if the key has expired or been revoked
    * Ensure billing is set up on your xAI account
  </Accordion>

  <Accordion title="Rate limits">
    * Free tier credits have usage limits
    * Upgrade your plan for higher throughput
    * Switch to a smaller Grok model for lighter tasks
  </Accordion>

  <Accordion title="Connection issues">
    * Check your network connection
    * Verify the xAI API service is available
    * Try again after a few minutes
  </Accordion>
</AccordionGroup>
