> ## 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 your API key never appears in the printed command. Instead, the shell resolves it when you run the command.

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

If you provide text, `--speaker` and `--model-id` are required. With no arguments, the command prints an example request.

The generated command saves audio to `output.wav`. It includes `--fail`, so an HTTP error stops curl instead of being written to the output file.

## Optional flags

| Flag | Short | Default | Description |
| - | - | - | - |
| `--speaker` | `-s` | `astra`\* | Voice speaker to use |
| `--model-id` | `-m` | `coda`\* | Model ID |
| `--lang` | `-l` | -- | BCP 47 language tag. Defaults to the model's own language |
| `--speed-alpha` | -- | `1` | Speed multiplier, which must be greater than 0. Higher is faster |
| `--sampling-rate` | -- | -- | Output sampling rate in Hz. Coda: `8000`, `16000`, `22050`, `24000`, `44100`, `48000`, `96000`. Mist v3: `4000`–`44100` |
| `--oneline` | -- | `false` | Output as a single line for easy copy-paste |
| `--api-url` | -- | -- | API URL override |

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

## Coda flags

The CLI rejects these flags for `mistv3`.

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

## Mist v3 flags

The CLI rejects these flags for `coda`.

| Flag | Description |
| - | - |
| `--inline-time-scale-factor` | Comma-separated per-segment speed values |
| `--pause-between-brackets` | Insert pause at bracketed markers |
| `--phonemize-between-brackets` | Phonemize text in brackets. On `mistv3`, English only (see [Custom pronunciation](/docs/custom-pronunciation)) |

## 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
```


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