Text-to-speech (File)

Synthesizes one or more input texts into speech using the specified voice. If no voice is provided, a novel voice will be generated dynamically. Optionally, additional context can be included to influence the speech’s style and prosody.

The response contains the generated audio file in the requested format.

Headers

X-Hume-Api-KeystringRequired

Request

This endpoint expects an object.

utteranceslist of objectsRequired

Utterances to be converted to speech output.

contextobjectOptional

Utterances to use as context for generating consistent speech style and prosody across multiple requests. These will not be converted to speech output.

formatobjectOptional

Specifies the output audio file format.

num_generationsintegerOptional>=1<=5Defaults to 1

Number of generations of the audio to produce.

1	from hume import HumeClient
2	from hume.tts import FormatMp3, PostedContextWithGenerationId, PostedUtterance
3
4	client = HumeClient(
5	api_key="YOUR_API_KEY",
6	)
7	client.tts.synthesize_file(
8	utterances=[
9	PostedUtterance(
10	text="Beauty is no quality in things themselves: It exists merely in the mind which contemplates them.",
11	description="Middle-aged masculine voice with a clear, rhythmic Scots lilt, rounded vowels, and a warm, steady tone with an articulate, academic quality.",
12	)
13	],
14	context=PostedContextWithGenerationId(
15	generation_id="09ad914d-8e7f-40f8-a279-e34f07f7dab2",
16	),
17	format=FormatMp3(),
18	num_generations=1,
19	)

Text-to-speech (File)

Headers

Request

Response

Errors