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

# Use xAI with the AI Gateway

> Call xAI Grok models through the ngrok AI Gateway with ngrok.ai credits or your own xAI API key, then send your first request.

[xAI](https://x.ai) builds the Grok family of models.

xAI supports Chat Completions and Responses requests.
Responses requests to xAI aren't stored, so `previous_response_id` isn't available. Send the full conversation in each request.

> [!NOTE]
>
> xAI is a **built-in provider** you can pay for with credits, so a provider key is optional.
> Add your own xAI key to bill usage to your xAI account instead of your ngrok.ai credits.

## Setup

### 1. Create an access key and add credits

Follow the [quickstart](https://ngrok.com/docs/ai-gateway/quickstart.md) to create an access key and purchase [credits](https://ngrok.com/docs/ai-gateway/concepts/credits.md) in [app.ngrok.ai](https://app.ngrok.ai).

### 2. Store your xAI API key (optional)

Skip this step to pay with credits.
To bring your own key, create an API key in your [xAI](https://x.ai) account. Then [add a provider key](https://ngrok.com/docs/ai-gateway/guides/attaching-provider-keys.md#add-a-provider-key) and [create an access key configuration](https://ngrok.com/docs/ai-gateway/guides/access-key-configurations.md#create-a-configuration) with an `xai` routing rule that uses it.

### 3. Send requests

Send requests with your access key:

```python theme={"theme":{"light":"css-variables","dark":"css-variables"}}
from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.ngrok.ai/v1",
    api_key="ng-xxxxx-g1-xxxxx",
)

response = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "Hello!"}]
)
```

## Available models

See the [model catalog](https://ngrok.com/docs/ai-gateway/reference/model-catalog.md#xai).

## Next steps

* [Provider keys](https://ngrok.com/docs/ai-gateway/guides/attaching-provider-keys.md)
* [Access key configurations](https://ngrok.com/docs/ai-gateway/guides/access-key-configurations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.