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

# rime curl

> Generate a ready-to-run curl command for the Rime TTS API.

Generate a curl command for making TTS API requests. The generated command uses `$(rime key)` as a shell expression, so it resolves your API key automatically when you paste and run it. Run without arguments to see an example.

```bash theme={null}
rime curl [TEXT]
```

When providing text, `--speaker` and `--model-id` are required. When run without arguments, defaults to an example request.

## Optional flags

| Flag              | Short | Default   | Description                                                                                                                 |
| ----------------- | ----- | --------- | --------------------------------------------------------------------------------------------------------------------------- |
| `--speaker`       | `-s`  | `astra`\* | Voice speaker to use                                                                                                        |
| `--model-id`      | `-m`  | `coda`\*  | Model ID                                                                                                                    |
| `--lang`          | `-l`  | `eng`     | Language code                                                                                                               |
| `--speed-alpha`   | --    | `1`       | Speed multiplier — must be greater than 0                                                                                   |
| `--sampling-rate` | --    | --        | Output sampling rate in Hz. Coda/Arcana: `8000`, `16000`, `22050`, `24000`, `44100`, `48000`, `96000`. Mist: `4000`–`44100` |
| `--oneline`       | --    | `false`   | Output as a single line for easy copy-paste                                                                                 |
| `--api-url`       | --    | --        | API URL override                                                                                                            |

## Arcana/arcanav2 flags

| Flag                   | Default | Description                  |
| ---------------------- | ------- | ---------------------------- |
| `--temperature`        | `0.5`   | Sampling temperature (0–1)   |
| `--top-p`              | `1`     | Top-p nucleus sampling (0–1) |
| `--max-tokens`         | `1200`  | Max output tokens (200–5000) |
| `--repetition-penalty` | `1.5`   | Repetition penalty (1–2)     |

## Mist/Mist v2/Mist v3 flags

| Flag                       | Description                              |
| -------------------------- | ---------------------------------------- |
| `--inline-speed-alpha`     | Comma-separated per-segment speed values |
| `--pause-between-brackets` | Insert pause at bracketed markers        |

## Mist/Mist v2 flags

These flags are only supported by `mist` and `mistv2`. They are not supported by `mistv3`.

| Flag                           | Description                                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------- |
| `--phonemize-between-brackets` | Phonemize text in brackets (see [Custom pronunciation](/docs/custom-pronunciation)) |
| `--no-text-normalization`      | Disable text normalization                                                          |
| `--save-oovs`                  | Save out-of-vocabulary words                                                        |

\*Defaults apply only when run without arguments. When text is provided, `--speaker` and `--model-id` are required.

## Examples

```bash theme={null}
# Show example curl command
rime curl

# Generate curl for custom text
rime curl "Hello from Rime" -s celeste -m coda

# Single-line output
rime curl "Hello" -s astra -m coda --oneline
```