> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puretalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clone Voice

> Creates a new voice clone based on an uploaded audio sample. The audio should be clear and contain at least 30 seconds of speech.



## OpenAPI

````yaml openapi-tts POST /v1/tts/clone-voice
openapi: 3.0.1
info:
  title: Puretalk AI
  description: Api Documentation for Puretalk AI
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.puretalk.ai/api
security:
  - ApiKeyAuth: []
paths:
  /v1/tts/clone-voice:
    post:
      summary: Clone a Voice
      description: >-
        Creates a new voice clone based on an uploaded audio sample. The audio
        should be clear and contain at least 30 seconds of speech.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - audio_clip
                - name
                - language
                - gender
              properties:
                audio_clip:
                  type: string
                  format: binary
                  description: >-
                    Audio file containing the voice sample to clone (Supported
                    formats: WAV, MP3, M4A)
                  pattern: .*\.(wav|mp3|m4a)$
                name:
                  type: string
                  example: My Cloned Voice
                  description: A descriptive name for the cloned voice
                description:
                  type: string
                  example: American Female
                  description: Additional details about the voice characteristics
                language:
                  type: string
                  enum:
                    - en
                    - fr
                    - de
                    - es
                    - pt
                    - zh
                    - ja
                    - hi
                    - it
                    - ko
                    - nl
                    - pl
                    - ru
                    - sv
                    - tr
                  default: en
                  description: Language of the voice
                gender:
                  type: string
                  enum:
                    - male
                    - female
                  example: female
                  description: Gender of the voice
            encoding:
              audio_clip:
                contentType: audio/wav, audio/mp3, audio/m4a
      responses:
        '200':
          description: Voice cloned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  msg:
                    type: string
                    example: Voice cloned successfully
                  err:
                    type: boolean
                    example: false
                  results:
                    type: object
                    properties:
                      voice_id:
                        type: string
                        format: uuid
                        example: 70756ba9-cfdd-4108-84de-3a24d3f86b34
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      required:
        - err
        - msg
      type: object
      properties:
        err:
          type: boolean
        msg:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Authorization header containing API key. You can find your API key in
        the dashboard under 'API Keys'.

````