> ## Documentation Index > Fetch the complete documentation index at: https://docs.vmeg.ai/llms.txt > Use this file to discover all available pages before exploring further. # Clone voice from sample audio (sync) > Clone a voice from a reference recording. The call is synchronous and returns when cloning finishes, which can take tens of seconds, so use a generous client timeout (for example 120 s). The voice is saved to **My voices** on the website and returned as `cv_*`; use it in `voiceSpeakers.selectedVoicesList`. `sampleLanguage` defaults to `en-US`; the engine is chosen automatically when `provider` is omitted. Requires a plan with voice cloning (`403` otherwise). ## OpenAPI ````yaml /api-reference/app-synced.json post /openapi/v1/app/task/clone-voice/create openapi: 3.1.0 info: title: VMEG Open API (App-Synced) description: >- Same protocol as the Standalone API, but every task, material, and cloned voice lives in your VMEG website account: jobs show up in **My tasks**, open in the editor, and can be re-exported. Poll `GET /openapi/v1/app/tasks/detail` for results (no webhooks). See [Standalone vs App-Synced](/guides/app-synced/comparison). Linked guides are written for the Standalone API. The steps are the same; use the `/openapi/v1/app` prefix instead of `/openapi/v1`. version: 1.0.0 servers: - url: https://api.vmeg.ai description: Production security: - apiKeyAuth: [] tags: - name: Media translation x-group: Video & audio translate and dub description: >- Translate and dub uploaded video/audio or a YouTube link on the same pipeline as vmeg.ai. The first pass renders the dubbed file; the job also appears in **My tasks** for editing and re-export. Poll [Query job status](/api-reference/app-synced/tasks/get-task-detail) for results. - name: Voice clone x-group: Voice cloning description: >- Clone a voice from a short recording. The voice is saved to **My voices** on the website and returned as `cv_*` for translate-and-dub jobs. - name: Task management x-group: Task status and history description: >- List, inspect, or delete the video/audio translation jobs in your VMEG account, including jobs created on the website. - name: Assets - Materials x-group: Upload files (materials) description: >- Upload and manage the files in your website material library (**My assets**). Finish the upload (single-file or multipart), then pass `materialId` to create-async. - name: Assets - Voices x-group: Voices (presets and clones) description: >- List preset system voices (`sv_*`) and manage your cloned voices (`cv_*`, same as **My voices** on the website). paths: /openapi/v1/app/task/clone-voice/create: post: tags: - Voice clone summary: Clone voice from sample audio (sync) description: >- Clone a voice from a reference recording. The call is synchronous and returns when cloning finishes, which can take tens of seconds, so use a generous client timeout (for example 120 s). The voice is saved to **My voices** on the website and returned as `cv_*`; use it in `voiceSpeakers.selectedVoicesList`. `sampleLanguage` defaults to `en-US`; the engine is chosen automatically when `provider` is omitted. Requires a plan with voice cloning (`403` otherwise). operationId: appCloneVoiceCreateSync parameters: - $ref: '#/components/parameters/IdempotencyKeyRequired' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AppCloneVoiceCreateRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AppCloneVoiceCreateResponse' components: parameters: IdempotencyKeyRequired: name: X-Idempotency-Key in: header required: true description: >- Required on mutating `POST` requests that create tasks or change persisted data (max 64 characters). See [Idempotency](/guides/idempotency). schema: type: string maxLength: 64 schemas: AppCloneVoiceCreateRequest: type: object properties: voiceName: type: string description: Display name for the cloned voice in your asset library provider: type: string enum: - V1 - V2 - V3 - V4 - V5 example: V1 description: >- Clone engine (`V1`–`V5`). See [Supported clone methods](/guides/supported-clone-methods). refAudio: type: string description: >- HTTPS reference audio URL (use `refAudioMaterialId` for uploaded files). Provide exactly one of the two. sampleLanguage: type: string example: zh-CN description: >- Sample language locale (BCP-47). See [Supported languages](/guides/supported-languages). sampleText: type: string description: Transcript of the reference audio (required) refAudioMaterialId: type: string description: Material ID of an uploaded audio/video file required: - voiceName - sampleText AppCloneVoiceCreateResponse: allOf: - $ref: '#/components/schemas/OpenApiResponseBase' - type: object properties: data: $ref: '#/components/schemas/OpenApiCloneVoiceDto' OpenApiResponseBase: type: object properties: code: type: integer example: 200 description: Business code; 200 means success message: type: string example: '' description: Human-readable detail when `code` is not success required: - code OpenApiCloneVoiceDto: type: object properties: voiceId: type: string description: Cloned voice ID. See [Voices](/guides/app-synced/comparison) name: type: string description: Display name of the clone provider: type: string description: >- Clone engine (`V1`–`V5`). See [Supported clone methods](/guides/supported-clone-methods). exampleLanguage: type: string description: Sample language locale (BCP-47) content: type: string description: Sample text or transcript associated with the clone audio: type: string description: Sample or reference audio URL createTime: type: string description: Record creation time updateTime: type: string description: Record last update time securitySchemes: apiKeyAuth: type: http scheme: bearer description: >- Send your API Key in the **`Authorization`** header (`Bearer `). See [Authentication](/guides/authentication). ````