# Clone Voice ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /voices/clone: post: summary: Clone Voice deprecated: false description: Clone a voice from a 3-second audio clip tags: - API Reference/Voice Management parameters: - name: x-api-key in: header description: '' required: true example: schema: type: string - name: version in: header description: '' required: true example: v1 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: audio: format: binary type: string description: 'Audio clip file. Supported formats: wav, mp3, flac, aiff' example: cmMtdXBsb2FkLTE3NDQxMTUwOTk4MzQtMg==/example.wav name: type: string description: Voice name example: '' description: description: Voice description example: '' type: string accent: description: Voice accent example: '' type: string gender: type: string enum: - Male - Female - Neutral - Unspecified x-apidog-enum: - value: Male name: '' description: '' - value: Female name: '' description: '' - value: Neutral name: '' description: '' - value: Unspecified name: '' description: '' description: Voice gender example: '' style: description: Voice style(s), comma-separated example: '' type: string enhance: type: boolean description: >- Whether to enhance (remove background noise of) the audio clip before cloning. Default: False example: '' required: - audio - name examples: {} responses: '200': description: '' content: application/json: schema: type: object properties: id: type: string description: Voice id name: type: string description: Voice name description: type: string description: Voice description language: type: string description: Voice language(s) (ISO 639-1), comma-separated examples: - en,fr,es,de,it,pt,ar,ru,ro,ja,he,hy,tr,hi,zh required: - id - name - description - language x-apidog-orders: - id - name - description - language example: id: 9a583567-7245-4b3a-85b3-c52769583567 name: Voice 1 description: My First Async Voice language: de,en,es,fr,it headers: {} x-apidog-name: Success '400': description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: INVALID_LANGUAGE message: Language code 'xx' is not supported. headers: {} x-apidog-name: INVALID_LANGUAGE '401': description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string extra: type: object properties: api_key: type: string x-apidog-orders: - api_key required: - error_code - message x-apidog-orders: - error_code - message - extra required: - detail x-apidog-orders: - detail example: detail: error_code: INVALID_API_KEY message: Invalid or expired API key. extra: api_key: sk_33... headers: {} x-apidog-name: INVALID_API_KEY '404': description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: VERSION_NOT_FOUND message: API version v0.9 not found. headers: {} x-apidog-name: VERSION_NOT_FOUND '413': description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: FILE_TOO_LARGE message: Uploaded file exceeds maximum allowed size of 10 MB. headers: {} x-apidog-name: FILE_TOO_LARGE '429': description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string extra: type: object properties: limit: type: integer retry_after_ms: type: integer x-apidog-orders: - limit - retry_after_ms required: - error_code - message x-apidog-orders: - error_code - message - extra required: - detail x-apidog-orders: - detail example: detail: error_code: RATE_LIMIT_EXCEEDED message: Rate limit exceeded. Please try again later. extra: limit: 120 retry_after_ms: 8500 headers: {} x-apidog-name: RATE_LIMIT_EXCEEDED '500': description: '' content: application/json: schema: type: object properties: message: type: string method: type: string url: type: string detail: type: string required: - message - method - url - detail x-apidog-orders: - message - method - url - detail example: message: Oops! Internal server error occurred. method: POST url: /v1/tts/stream detail: 'Error: Traceback #42' headers: {} x-apidog-name: Server Error x-400:FORMAT_NOT_RECOGNIZED: description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: FORMAT_NOT_RECOGNIZED message: Audio format not recognized or unsupported. headers: {} x-apidog-name: FORMAT_NOT_RECOGNIZED x-429:VOICE_CLONE_LIMIT_EXCEEDED: description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: VOICE_CLONE_LIMIT_EXCEEDED message: Voice cloning limit exceeded. headers: {} x-apidog-name: VOICE_CLONE_LIMIT_EXCEEDED x-400:SHORT_SPEECH_DURATION: description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: SHORT_SPEECH_DURATION message: Speech duration is too short. Minimum required is 3 seconds. headers: {} x-apidog-name: SHORT_SPEECH_DURATION x-400:BAD_SPEECH_QUALITY: description: '' content: application/json: schema: type: object properties: detail: type: object properties: error_code: type: string message: type: string required: - error_code - message x-apidog-orders: - error_code - message required: - detail x-apidog-orders: - detail example: detail: error_code: BAD_SPEECH_QUALITY message: >- Speech quality is too low, please try again with a higher quality. headers: {} x-apidog-name: BAD_SPEECH_QUALITY security: [] x-apidog-folder: API Reference/Voice Management x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/909580/apis/api-16699697-run components: schemas: {} securitySchemes: {} servers: [] security: [] ```