# Pronouncing digits one‑by‑one

Need your TTS to spell out numbers digit‑by‑digit instead of reading them as whole numbers? Wrap the sequence in a `<digits>` block.

| Element               | Required | Description                                                                                                                                                |
| --------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<digits>`            | ✓        | Opening tag that starts the digit‑override region.                                                                                                         |
| *Digits & separators* | ✓        | Any digits (`0‑9`) and optional separators: spaces, dashes, parentheses, periods. Separators are skipped (or introduce brief pauses) during pronunciation. |
| `</digits>`           | ✓        | Closing tag.                                                                                                                                               |

>The tag works across all languages supported by the model. Digits are pronounced in the language currently active:
>    - Auto-detected language, or
>   - the language explicitly forced with *language* flag.


**Example**

```text
My phone number is <digits>(123) 456‑7890</digits> and my credit card is <digits>1234‑5678‑9012‑3456</digits>.
```


The engine will voice:

> "My phone number is **one two three four five six seven eight nine zero** and my credit card is **one two three four five six seven eight nine zero one two three four five six**."

---

### Inline digits‑pronunciation example

```jsonc
{
  "model_id": "async_flash_v1.0",
  "transcript": "My phone number is <digits>(123) 456-7890</digits> and my credit card is <digits>1234-5678-9012-3456</digits>.",
  "voice": { "mode": "id", "id": "e0f39dc4-f691-4e78-bba5-5c636692cc04" },
  "output_format": {
    "container": "raw",
    "encoding": "pcm_s16le",
    "sample_rate": 44100
  }
}
```

The engine will render:

> "My phone number is *one two three four five six seven eight nine zero* and my credit card is *one two three four five six seven eight nine zero one two three four five six*."


---