Skip to main content
POST
/
v1
/
voice-previews
/
{generated_voice_id}
/
save
cURL
curl \
  --request POST \
  --url "https://api.breeze.blue/v1/voice-previews/gvi_01hpreview/save" \
  --header "xi-api-key: $BREEZE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "voice_name": "Brand Narrator"
}'
{
  "voice_id": "<string>",
  "name": "<string>",
  "category": "<string>",
  "voice_type": "<string>",
  "settings": {
    "guidance_scale": 1
  },
  "labels": {},
  "preview_url": "<string>",
  "description": "<string>",
  "created_at_unix": 123
}

Authorizations

xi-api-key
string
header
required

Breeze Developer API key.

Path Parameters

generated_voice_id
string
required

Preview ID returned by a voice preview creation endpoint.

Body

application/json
voice_name
string
required

Display name for the saved voice.

Required string length: 1 - 120
voice_description
string | null

Optional description stored with the saved voice.

Maximum string length: 1000
labels
Labels · object

Optional voice labels to store with the saved voice.

Response

Saved voice.

voice_id
string
required
name
string
required
category
string
required
voice_type
string
required
settings
VoiceSettingsResponse · object
required
labels
Labels · object
preview_url
string | null
description
string | null
created_at_unix
integer | null