Skip to main content
curl --request POST \
  --url https://optimize.rime.ai/textnorm \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --fail \
  --data '{
  "text": "<string>"
}'

{
  "normalized": "one two three four, one, eight hundred, four four four, four one four one"
}
All requests require authentication with a bearer token in the Authorization header: Authorization: Bearer YOUR_API_KEY. See API authentication for how to create a key.

​
Overview

This API endpoint returns the normalized form of an input string — the way Rime’s TTS models interpret numbers, phone numbers, dates, and other non-standard words before synthesis. Use it to preview how a given input will be spoken, or to debug unexpected pronunciations of digits, sequences, and punctuation.
This endpoint covers Rime’s English text normalization. For details on what’s normalized natively, known gaps, and how to pre-normalize problematic patterns, see Text normalization.

​
Example

A request takes only the string text, for example: 
curl -X POST https://optimize.rime.ai/textnorm \
     -H "Authorization: Bearer $(rime key)" \
     -H "Content-Type: application/json" \
     -d '{"text":"1234 1,2,3,4 1-800-444-4141 "}'
The response includes the normalized string: 
{"normalized":"one two three four, one , two , three , four, one, eight hundred, four four four, four one four one"}

​
Variable Parameters

​
text
string
required
The string you’d like to normalize. Numbers, phone numbers, and other non-standard words will be expanded into their spoken form.
curl --request POST \
  --url https://optimize.rime.ai/textnorm \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --fail \
  --data '{
  "text": "<string>"
}'

{
  "normalized": "one two three four, one, eight hundred, four four four, four one four one"
}