Voice Guide

Hume’s text-to-speech (TTS) API lets you specify which voice to use when synthesizing speech. You can use a custom voice that you have saved or select one from Hume’s Voice Library.

This guide explains how to specify a voice across all of Hume’s TTS endpoints.

Voice reference options

You can specify a voice by name or id. If you use name, include a provider (defaults to CUSTOM_VOICE). To reference a voice from Hume’s Voice Library by name, set the provider to HUME_AI.

1
{
2
  "voice": {
3
    "id": "9e068547-5ba4-4c8e-8e03-69282a008f04"
4
  }
5
}

Specify a voice in your request

To set a voice, include the voice field in the first utterance of your request. That voice is used for all following utterances unless you override it later.

Voice specification works the same across streaming and non-streaming endpoints. The code snippets below demonstrate how to set the voice in your TTS request.

1
curl https://api.hume.ai/v0/tts/stream/json \
2
  -H "X-Hume-Api-Key: <apiKey>" \
3
  --json '{
4
  "utterances": [
5
    {
6
      "text": "Beauty is no quality in things themselves: It exists merely in the mind which contemplates them.",
7
      "voice": {
8
        "id": "9e068547-5ba4-4c8e-8e03-69282a008f04"
9
      }
10
    }
11
  ]
12
}'

Resources