BEbeyondwords
Voices

Create voice

Changed on

Creates a voice in your organization.

post/organization/voices

Request

  • Base URL
    https://api.beyondwords.io/v1
  • URL
    https://api.beyondwords.io/v1/organization/voices
  • Auth
    API key in header X-Api-Key

Request body

namestring required

The name of the voice

type'instant' | 'professional' required

The type of voice

speaker_idinteger required

The speaker to associate with the voice

cloning_consentstring

The URL of the cloning consent audio

speaking_rateinteger

The speaking rate of the voice (defaults to 100)

multilingual_modeboolean
expressivenessnumber
use_speaker_boostboolean nullable
similarity_boostnumber nullable
stylenumber nullable
clone_strengthnumber nullable

Only applied to ElevenLabs professional voice clones on eleven_v4 / eleven_v4_turbo

gender'male' | 'female' | 'neutral'

Response

successful

idinteger

Unique identifier for the object

namestring

The name of the voice

type'premade' | 'instant' | 'professional' | 'generated'

The type of the voice

status'draft' | 'recording' | 'processing' | 'review' | 'enabled' | 'deprecated' | 'disabled' | 'unavailable'

The status of the voice

preview_statuses'processing' | 'processed'

The preview status of the voice for its primary language

script_idsinteger[]

The script IDs associated with the voice

speaking_rateinteger

The speaking rate of the voice

multilingual_modeboolean
expressivenessnumber nullable
use_speaker_boostboolean nullable
similarity_boostnumber nullable
stylenumber nullable
clone_strengthnumber nullable

Only applied to ElevenLabs professional voice clones on eleven_v4 / eleven_v4_turbo

cloning_consentstring nullable

The cloning consent URL for instant and professional voices

clone_errorsobject[]

An array of voice cloning errors in the standard error format

createdstring date-time

Time at which the object was created (ISO 8601)

updatedstring date-time

Time at which the object was updated (ISO 8601)

logo_patterninteger nullable

Logo pattern number

logo_color'red' | 'green' | 'blue' | 'purple' | 'gray' | 'pink' | 'cyan' nullable

Logo pattern color

gender'male' | 'female' | 'neutral' nullable

The gender of the voice

languagestring

The language of the voice

secondary_languagesstring[]

The secondary languages of the voice

servicestring

The source of the voice

model_idstring nullable
expected_model_idsstring[] nullable

Model IDs the voice will be available for once cloning finishes. Only present while the voice is recording or processing

preview_urlstring nullable

The preview URL of the voice

premiumboolean

Whether the voice is premium or not

exclusiveboolean

Whether the voice is exclusive or not

customboolean

The custom flag of the voice

additionalboolean
pauses_supportedboolean
clone_strength_supportedboolean

Whether the clone_strength voice setting is applied for this voice

Changes

  • 994b9853e685Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status