Clone Voice

FreshPOST

POST https://api.creatify.ai/api/voices/clone/

Clone a voice from an audio sample. The cloned voice can then be used in avatar creation, text-to-speech, and other voice-enabled endpoints.

Request Body

Name	Type	Required	Description
audio_url	string	Yes	URL to an audio sample of the voice to clone
name	string	Yes	Name for the cloned voice

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key
Content-Type	string	Yes	application/json

Example Request

curl -X POST 'https://api.creatify.ai/api/voices/clone/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "audio_url": "https://example.com/voice-sample.mp3",
    "name": "My Custom Voice"
  }'

Response

{
  "id": "cloned-voice-001",
  "name": "My Custom Voice",
  "status": "processing",
  "created_at": "2024-01-15T10:30:00Z"
}

When cloning completes:

{
  "id": "cloned-voice-001",
  "name": "My Custom Voice",
  "status": "done",
  "preview_url": "https://cdn.creatify.ai/voices/cloned-voice-001-preview.mp3",
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

Code	Description
201	Voice cloning started
400	Bad request -- invalid audio URL or format
401	Unauthorized -- invalid API credentials
402	Insufficient credits
429	Rate limit exceeded
500	Internal server error

TIP

For best cloning results, provide a clear audio sample of at least 30 seconds with minimal background noise. Speech-only recordings produce the most accurate clones.

WARNING

Voice cloning should only be used with audio you have rights to use. Ensure you have proper consent before cloning any voice.