Create voice | Hume API

Saves a new custom voice to your account using the specified TTS generation ID.

Once saved, this voice can be reused in subsequent TTS requests, ensuring consistent speech style and prosody. For more details on voice creation, see the Voices Guide.

Authentication

X-Hume-Api-Keystring

API Key authentication via header

Request

This endpoint expects an object.

• generation_id string Required
  A unique ID associated with this TTS generation that can be used as context for generating consistent speech style and prosody across multiple requests.

• name string Required
  The name of a Voice.

Response

Successful Response

• id string or null format: "uuid4"
  The unique ID associated with the Voice.

• name string
  The name of a Voice.

• provider enum
  Specifies the source provider associated with the chosen voice.

• HUME_AI: Select voices from Hume’s Voice Library, containing a variety of preset, shared voices.

  • CUSTOM_VOICE: Select from voices you’ve personally generated and saved in your account.

If no provider is explicitly set, the default provider is CUSTOM_VOICE. When using voices from Hume’s Voice Library, you must explicitly set the provider to HUME_AI.

Preset voices from Hume’s Voice Library are accessible by all users. In contrast, your custom voices are private and accessible only via requests authenticated with your API key.

Allowed values: HUME_AI, CUSTOM_VOICE

Errors

• 422
  Unprocessable Entity Error