Text-to-speech (File)

POST

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.

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.

Response

abc

File DownloadBase64 string or null

Errors

Built with

1	curl -X POST https://api.hume.ai/v0/tts/file \
2	-H "X-Hume-Api-Key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"utterances": [
6	{
7	"text": "Beauty is no quality in things themselves: It exists merely in the mind which contemplates them.",
8	"description": "Middle-aged masculine voice with a clear, rhythmic Scots lilt, rounded vowels, and a warm, steady tone with an articulate, academic quality."
9	}
10	],
11	"context": {
12	"generation_id": "09ad914d-8e7f-40f8-a279-e34f07f7dab2"
13	},
14	"format": {
15	"type": "mp3"
16	},
17	"num_generations": 1
18	}'