# `LLMDB.Sources.XAI`
[🔗](https://github.com/agentjido/llm_db/blob/main/lib/llm_db/sources/xai.ex#L1)

Remote source for xAI (Grok) models (https://api.x.ai/v1/models).

- `pull/1` fetches data from xAI API and caches locally
- `load/1` reads from cached file (no network call)

## Options

- `:url` - API endpoint (default: "https://api.x.ai/v1/models")
- `:api_key` - xAI API key (required, or set `XAI_API_KEY` env var)
- `:region` - Optional regional endpoint (`:us_east_1` or `:eu_west_1`)
- `:req_opts` - Additional Req options for testing

## Configuration

Cache directory can be configured in application config:

    config :llm_db,
      xai_cache_dir: "priv/llm_db/remote"

Default: `"priv/llm_db/remote"`

## Regional Endpoints

You can use regional endpoints for data residency:

- `:us_east_1` - `https://us-east-1.api.x.ai/v1/models`
- `:eu_west_1` - `https://eu-west-1.api.x.ai/v1/models`

## Usage

    # Pull remote data and cache (requires API key)
    mix llm_db.pull --source xai

    # Pull with regional endpoint
    mix llm_db.pull --source xai --region eu_west_1

    # Load from cache
    {:ok, data} = XAI.load(%{})

# `transform`

Transforms xAI API response to canonical Zoi format.

xAI uses OpenAI-compatible format.

## Input Format (xAI)

```json
{
  "object": "list",
  "data": [
    {
      "id": "grok-4-fast-reasoning",
      "object": "model",
      "created": 1234567890,
      "owned_by": "xai"
    }
  ]
}
```

## Output Format (Canonical Zoi)

```elixir
%{
  "xai" => %{
    id: :xai,
    name: "xAI",
    models: [
      %{
        id: "grok-4-fast-reasoning",
        provider: :xai,
        extra: %{
          created: 1234567890,
          owned_by: "xai"
        }
      }
    ]
  }
}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*