Text-to-speech (Json)

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 includes the base64-encoded audio and metadata in JSON 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

Successful Response

generationslist of objects

request_idstringOptional

A unique ID associated with this request for tracking and troubleshooting. Use this ID when contacting support for troubleshooting assistance.

Errors

1 curl -X POST https://api.hume.ai/v0/tts \ 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 "utterances": [ 13 { 14 "text": "How can people see beauty so differently?", 15 "description": "A curious student with a clear and respectful tone, seeking clarification on Hume\'s ideas with a straightforward question." 16 } 17 ] 18 }, 19 "format": { 20 "type": "mp3" 21 }, 22 "num_generations": 1 23 }'

1 { 2 "generations": [ 3 { 4 "audio": "//PExAA0DDYRvkpNfhv3JI5JZ...etc.", 5 "duration": 7.44225, 6 "encoding": { 7 "format": "mp3", 8 "sample_rate": 24000 9 }, 10 "file_size": 120192, 11 "generation_id": "795c949a-1510-4a80-9646-7d0863b023ab", 12 "snippets": [ 13 [ 14 { 15 "audio": "//PExAA0DDYRvkpNfhv3JI5JZ...etc.", 16 "id": "37b1b1b1-1b1b-1b1b-1b1b-1b1b1b1b1b1b", 17 "text": "Beauty is no quality in things themselves: It exists merely in the mind which contemplates them." 18 } 19 ] 20 ] 21 } 22 ], 23 "request_id": "66e01f90-4501-4aa0-bbaf-74f45dc15aa725906" 24 }

1	curl -X POST https://api.hume.ai/v0/tts \
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	"utterances": [
13	{
14	"text": "How can people see beauty so differently?",
15	"description": "A curious student with a clear and respectful tone, seeking clarification on Hume\'s ideas with a straightforward question."
16	}
17	]
18	},
19	"format": {
20	"type": "mp3"
21	},
22	"num_generations": 1
23	}'

1	{
2	"generations": [
3	{
4	"audio": "//PExAA0DDYRvkpNfhv3JI5JZ...etc.",
5	"duration": 7.44225,
6	"encoding": {
7	"format": "mp3",
8	"sample_rate": 24000
9	},
10	"file_size": 120192,
11	"generation_id": "795c949a-1510-4a80-9646-7d0863b023ab",
12	"snippets": [
13	[
14	{
15	"audio": "//PExAA0DDYRvkpNfhv3JI5JZ...etc.",
16	"id": "37b1b1b1-1b1b-1b1b-1b1b-1b1b1b1b1b1b",
17	"text": "Beauty is no quality in things themselves: It exists merely in the mind which contemplates them."
18	}
19	]
20	]
21	}
22	],
23	"request_id": "66e01f90-4501-4aa0-bbaf-74f45dc15aa725906"
24	}