Voice & Language Configuration

Voice and language configurations define supported voices and languages for text-to-speech synthesis and speech-to-text recognition. Referenced by support models and provisioning chains.

Source: src/core/service-configuration/voice-language.schema.ts

---

Voice

Synthetic voice options for text-to-speech (TTS) synthesis.

Schema: VoiceSchema

Attributes

Attribute	Type	Required	Default	Description
voiceId	string	Yes	—	Unique identifier for the voice
name	string	Yes	—	Human-readable name
description	string	Yes	—	Voice characteristics description
gender	enum	Yes	—	Gender classification. One of male, female, or neutral.
language	string | null	No	—	Optimal language code (e.g., 'en-US')
isDefault	boolean	No	false	Whether this is the default voice

---

Language

Language configuration for speech processing.

Schema: LanguageSchema

Attributes

Attribute	Type	Required	Default	Description
languageId	string	Yes	—	Unique identifier (e.g., 'en-us')
name	string	Yes	—	Human-readable name with region
code	string	Yes	—	ISO 639-1 code with region (e.g., 'en-US')
isDefault	boolean	No	false	Whether this is the platform default
isExperimental	boolean	No	false	Whether in experimental support

---

Example

Voice

{
  "voiceId": "adam",
  "name": "Adam",
  "description": "Deep, authoritative male voice suitable for professional announcements",
  "gender": "male",
  "language": "en-US",
  "isDefault": true
}

Language

{
  "languageId": "en-us",
  "name": "English (United States)",
  "code": "en-US",
  "isDefault": true,
  "isExperimental": false
}

---

Helper Functions

Function	Description
validateSupportedVoices(voices)	Validates array of voices
isValidVoice(voice)	Type guard for Voice validation

---

Related

• Support LLM - Uses voices and languages for model configuration
• Provisioning Config - References voices in TTS configuration