> ## Documentation Index
> Fetch the complete documentation index at: https://rimelabs-docs-coda-websocket-reference.mintlify.site/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]
```

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

## 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; must be greater than 0                                                                             |
| `--sampling-rate` | --    | --        | Output sampling rate in Hz. Coda: `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                                                                                                     |

## Coda flags

These flags apply to Coda requests:

| 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/Mist v2/Mist v3 flags

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

## Mist/Mist v2 flags

Only `mist` and `mistv2` support these flags; `mistv3` does not.

| Flag                           | Description                                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------- |
| `--phonemize-between-brackets` | Phonemize text in brackets (see [Custom pronunciation](/docs/custom-pronunciation)) |
| `--no-text-normalization`      | Disable text normalization                                                          |

\*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
```