Language codes
The optionallanguage field tells text normalization how to read out numbers, dates, currency, and abbreviations. When it is unset, normalization detects the language from the text. Set it when you know the language for the most reliable results.
- Use ISO 639-3, three letters.
eng,jpn,pol,rus, andcmnare valid; two-letter ISO 639-1 codes such asen,ja, orzhare not and return400 invalid_field_value. Letter case doesnโt matter. A few alternative ISO 639-3 codes are also accepted, such aszhofor Chinese andarbfor Arabic. - Leave it unset when unsure. A valid but wrong code is accepted, and numbers and dates are then normalized as the wrong language.
- The same codes work everywhere.
languageonPOST /v1/audio/speechand in the speech WebSocketstartevent takes the same values.
For any other language, use its ISO 639-3 code as listed in the ISO 639-3 registry.