TopLevelVoiceConfig

TopLevelVoiceConfig<L> = ElevenLabsVoiceConfig | { accent?: string; modelType?: "expressive"; name: BuiltInVoiceName<L>; pacing?: string; style: string; } | { accent?: never; modelType?: Exclude<ModelType, "expressive">; name: BuiltInVoiceName<L>; pacing?: number; style?: never; }

Defined in: voiceConfig.ts:44

Default voice shared across all languages. seed is not allowed here — use a per-language voice override instead.

Type Parameters

L

L extends Lang = Lang

Union Members

ElevenLabsVoiceConfig

---

Type Literal

{ accent?: string; modelType?: "expressive"; name: BuiltInVoiceName<L>; pacing?: string; style: string; }

accent?

optional accent?: string

Accent description for expressive synthesis. The more specific, the better — e.g. 'Southern American English' or 'Received Pronunciation British'. Omitted from the prompt when not set — the voice uses its natural default.

modelType?

optional modelType?: "expressive"

Can be omitted when style is set — expressive is implied. Business tier only.

name

name: BuiltInVoiceName<L>

pacing?

optional pacing?: string

Pacing description for expressive synthesis. Describes the overall speed and tempo — e.g. 'Measured and deliberate' or 'Brisk and energetic'.

style

style: string

Speaking style prompt for expressive synthesis. Business tier only. Implies expressive model type.

---

Type Literal

{ accent?: never; modelType?: Exclude<ModelType, "expressive">; name: BuiltInVoiceName<L>; pacing?: number; style?: never; }

accent?

optional accent?: never

modelType?

optional modelType?: Exclude<ModelType, "expressive">

TTS model type — modelTypes.expressive or modelTypes.consistent. Defaults to consistent.

name

name: BuiltInVoiceName<L>

pacing?

optional pacing?: number

Speaking rate for consistent synthesis. Valid range: 0.25 to 2.

style?

optional style?: never