> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# Grok

> Learn how to use xAI's Grok TTS voices with SignalWire AI Voice applications.

Grok is xAI's low-latency text-to-speech engine with a small set of multilingual voices.

Grok TTS does not take a model parameter. The voice string is just `grok.<voiceId>` —
never append a `:model` suffix.

## Voices

Grok provides five voices: `ara`, `eve`, `leo`, `rex`, and `sal`.
`eve` is the default, and is also used as the fallback when an unrecognized voice is requested.

See [xAI's documentation](https://docs.x.ai/) for voice details.

## Languages

Grok voices are multilingual. SignalWire passes the language code you set on the
[`languages`](/docs/swml/reference/ai/languages) SWML method (any BCP-47 code, such as `en-US`
or `fr-FR`) to Grok, and multilingual mode maps to automatic language detection.

## Usage

A voice identifier string has two parts: the `grok` engine code and a voice ID.

**Format**: `grok.<voiceId>`

* `voiceId` (required): one of the [voices](#voices) above (for example, `eve`).

**Examples**:

```text
grok.eve
grok.ara
```

---

## Build with Grok on SignalWire

### Create a Space and add credit

If you don't have one yet, you'll need to
[create a SignalWire Space](/docs/platform/signing-up-for-a-space).
Be sure to add some credit to test with.

### Add a new Resource

Navigate to the **Resources** tab in your [SignalWire Dashboard](https://my.signalwire.com) and click **+ Add New** to create a new Resource.

### Create a SWML Script

From the Resources menu, select **SWML Script**.
Name it something fun and recognizable.
Ours is titled Grok Wizard.

Next, paste the following starter script into the text box, and hit <kbd>Save</kbd>:

```yaml
version: 1.0.0
sections:
  main:
  - ai:
      prompt:
        text: |
          You're Eve, a voice from xAI's Grok TTS engine!
          Introduce yourself, and have a conversation about programmable unified communications on the SignalWire platform.
      languages:
      - name: English
        code: en-US
        voice: grok.eve
```

### Buy and assign a phone number

Navigate to the **Phone Numbers** section of the Dashboard's left sidebar menu.

Purchase a phone number and assign it to the desired SWML script.

In the Dashboard, open **Phone Numbers** > **Purchased**, select the number, and open its edit page. Under **Inbound Call Settings**, select **+ Assign Resource**, choose the SWML script, and save the settings.

### Give it a call!

Call the number you just assigned to chat with your new AI voice application on the phone.

## Next steps with SWML

Now you've deployed your very first SignalWire voice AI application using Grok voices.
Next, dive deeper into SWML to explore its capabilities!

#### [Methods reference](/docs/swml)

Documentation for all SWML methods

#### [AI in SWML](/docs/swml/guides)

Build advanced AI applications using SignalWire Markup Language

#### [Guides](/docs/swml/guides)

SWML guides and demo applications