voices

Add Voice

Changed on

Add a new voice to your collection of voices in VoiceLab.

post/v1/voices/add

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/voices/add
  • Auth
    none declared

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body multipart/form-data

namestring required

The name that identifies this voice. This will be displayed in the dropdown of the website.

filesstring[] required

A list of file paths to audio recordings intended for voice cloning.

remove_background_noiseboolean

If set will remove background noise for voice samples using our audio isolation model. If the samples do not include background noise, it can make the quality worse.

descriptionstring nullable

A description of the voice.

Example request

{
  "name": "John Smith",
  "remove_background_noise": true,
  "description": "An old American male voice with a slight hoarseness in his throat. Perfect for news."
}

Response

Successful Response

voice_idstring required

The ID of the newly created voice.

requires_verificationboolean required

Whether the voice requires verification

Example response

{
  "requires_verification": false,
  "voice_id": "c38kUX8pkfYO2kHyqfFy"
}

Changes

  • 5b595807512cRevision changes
    • info

      api operation id Add_voice_v1_voices_add_post removed and replaced with add_voice

    • info

      request property list-of-types was widened by adding types object to media type multipart/form-data

  • 503db4198a44Revision changes
    • info

      header request parameter xi-api-key list-of-types was widened by adding types null

    • info

      for the header request parameter xi-api-key, the type was generalized from string to no type

    • info

      request property list-of-types was widened by adding types null to media type multipart/form-data

    • info

      request property list-of-types was widened by adding types null to media type multipart/form-data