POST
/
v1
/
voices
curl --request POST \
  --url https://api.bland.ai/v1/voices \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "voice_name": "<string>",
  "description": "<string>",
  "voice_id": 123,
  "reduce_latency": true,
  "interruption_threshold": 123,
  "language": "<string>",
  "voice_settings": {}
}'
{
    "message": "Successfully created new voice preset with an id of 79698ec7-35c5-44ff-8ad8-2f63ec6104d3",
    "voice": {
        "voice_preset_id": "79698ec7-35c5-44ff-8ad8-2f63ec6104d3",
        "voice_name": "Fast Matt",
        "description": "Matt but twice as fast",
        "reduce_latency": true,
        "interruption_threshold": null,
        "language": "ENG",
        "voice_settings": "{\"speed\":2}",
        "editable": true,
        "public": false,
        "created_at": "2024-01-08T20:19:23.531924+00:00"
    }
}

Headers

authorization
string
required

Your API key for authentication.

Request Body

voice_name
string
required

The name for the new voice preset.

description
string

A description of the voice preset.

voice_id
integer

The existing voice_id that will be mapped to the new voice preset.

reduce_latency
boolean

The current reduce_latency setting that will be mapped to the new voice preset.

interruption_threshold
integer
default: 50

The threshold for voice interruption settings.

language
string

The language code for the voice preset.

voice_settings
object

A JSON object containing specific settings for the voice.

Optional Settings:

  • speed - Multiplies the speed of the voice (only reduce_latency: true voices)
  • interruption_threshold - Delay before responding (in milliseconds)
  • stability - Lower for more emotion, higher for more stability
  • similarity - Match cloned voice more closely
  • speech_flexibility - Flexible pronunciation
  • optimize_for - speed_max, speed, quality, quality_max or null

Response

message
string

Confirmation message indicating successful creation of the new voice preset.

voice
object

The newly created voice preset.