Skip to main content

​
Telnyx Voice: Voice Design — Documentation Index

Voice Design documentation within the Voice section of the Telnyx developer docs (https://developers.telnyx.com). Root index: https://developers.telnyx.com/llms.txt · Voice index: https://developers.telnyx.com/development/llms/voice-llms-txt.md · Full content for this subsection: https://developers.telnyx.com/development/llms/voice-voice-design-llms-full-txt.md

​

  • Overview: Create custom voices from text descriptions or audio recordings, then use them across all Telnyx voice products.

​
Design a Voice

  • Overview: Use AI to generate voices from natural language descriptions — understand the concepts, then create one via the portal or API.
  • Quickstart: Create a custom synthetic voice step-by-step using the Telnyx Voice Design portal or API, including prompts, reference audio, and provider selection.
  • Parameters: Provider differences and generation parameters for the Voice Design API.
  • Prompting Guide: Write voice descriptions that produce consistent, high-quality results — format templates, dimension guides, and common pitfalls.

​
Clone from Audio

  • Overview: Clone a voice from a short audio recording — capture a speaker’s identity from a sample.
  • Quickstart: Clone a voice step-by-step — upload a file, record in the browser, or use the API.
  • Parameters: Models, audio requirements, and async flows for the Voice Clone API.
  • Responses: Reference for the Voice Clone API response, including the voice ID format, status fields, sample audio URLs, and timestamps returned for each clone.
  • Errors: Reference for error codes returned by the Telnyx Voice Clone API, including general errors and provider-specific failures with troubleshooting tips.

​
Using Custom Voices

  • Using Custom Voices: Use your custom voice clones across AI Assistants, Call Control, and the TTS API.

​
API Reference (Voice Design)

​
Voice Designs

  • List voice designs: Returns a paginated list of voice designs belonging to the authenticated account.
  • Create or add a version to a voice design: Creates a new voice design (version 1) when voice_design_id is omitted. When voice_design_id is provided, adds a new version to the existing design instead…
  • Get a voice design: Returns the latest version of a voice design, or a specific version when ?version=N is provided. The id parameter accepts either a UUID or the design name.
  • Rename a voice design: Updates the name of a voice design. All versions retain their other properties.
  • Delete a voice design: Permanently deletes a voice design and all of its versions. This action cannot be undone.
  • Download voice design audio sample: Downloads the WAV audio sample for the voice design. Returns the latest version’s sample by default, or a specific version when ?version=N is provided. The `…
  • Delete a specific version of a voice design: Permanently deletes a specific version of a voice design. The version number must be a positive integer.

​
Voice Clones