Clone Voice

cURL

curl --request POST \
  --url https://api.creatify.ai/api/voices/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "original_audio_url": "<string>",
  "name": "<string>",
  "voice_provider": "fishaudio"
}
'

import requests

url = "https://api.creatify.ai/api/voices/"

payload = {
    "original_audio_url": "<string>",
    "name": "<string>",
    "voice_provider": "fishaudio"
}
headers = {
    "X-API-ID": "<api-key>",
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-ID': '<api-key>',
    'X-API-KEY': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({original_audio_url: '<string>', name: '<string>', voice_provider: 'fishaudio'})
};

fetch('https://api.creatify.ai/api/voices/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.creatify.ai/api/voices/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'original_audio_url' => '<string>',
    'name' => '<string>',
    'voice_provider' => 'fishaudio'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-ID: <api-key>",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.creatify.ai/api/voices/"

	payload := strings.NewReader("{\n  \"original_audio_url\": \"<string>\",\n  \"name\": \"<string>\",\n  \"voice_provider\": \"fishaudio\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-ID", "<api-key>")
	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.creatify.ai/api/voices/")
  .header("X-API-ID", "<api-key>")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"original_audio_url\": \"<string>\",\n  \"name\": \"<string>\",\n  \"voice_provider\": \"fishaudio\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.creatify.ai/api/voices/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-ID"] = '<api-key>'
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"original_audio_url\": \"<string>\",\n  \"name\": \"<string>\",\n  \"voice_provider\": \"fishaudio\"\n}"

response = http.request(request)
puts response.read_body

{
  "name": "<string>",
  "accents": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "accent_name": "<string>",
      "preview_url": "<string>"
    }
  ],
  "gender": "male"
}

POST

api

voices

cURL

curl --request POST \
  --url https://api.creatify.ai/api/voices/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "original_audio_url": "<string>",
  "name": "<string>",
  "voice_provider": "fishaudio"
}
'

import requests

url = "https://api.creatify.ai/api/voices/"

payload = {
    "original_audio_url": "<string>",
    "name": "<string>",
    "voice_provider": "fishaudio"
}
headers = {
    "X-API-ID": "<api-key>",
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-ID': '<api-key>',
    'X-API-KEY': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({original_audio_url: '<string>', name: '<string>', voice_provider: 'fishaudio'})
};

fetch('https://api.creatify.ai/api/voices/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.creatify.ai/api/voices/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'original_audio_url' => '<string>',
    'name' => '<string>',
    'voice_provider' => 'fishaudio'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-ID: <api-key>",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.creatify.ai/api/voices/"

	payload := strings.NewReader("{\n  \"original_audio_url\": \"<string>\",\n  \"name\": \"<string>\",\n  \"voice_provider\": \"fishaudio\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-ID", "<api-key>")
	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.creatify.ai/api/voices/")
  .header("X-API-ID", "<api-key>")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"original_audio_url\": \"<string>\",\n  \"name\": \"<string>\",\n  \"voice_provider\": \"fishaudio\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.creatify.ai/api/voices/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-ID"] = '<api-key>'
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"original_audio_url\": \"<string>\",\n  \"name\": \"<string>\",\n  \"voice_provider\": \"fishaudio\"\n}"

response = http.request(request)
puts response.read_body

{
  "name": "<string>",
  "accents": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "accent_name": "<string>",
      "preview_url": "<string>"
    }
  ],
  "gender": "male"
}

Choosing a provider

voice_provider selects the engine that clones the voice. It defaults to fishaudio; you only need to set it if you specifically want ElevenLabs.

	`fishaudio` (default)	`elevenlabs`
How many voices you can clone	Unlimited	One voice slot per voice. Every workspace has 3 slots; more can be purchased.
When the limit is reached	Never	`400` — the error names the ElevenLabs cap and reminds you that `fishaudio` is unlimited
`voice.model` on AI Avatar v2	Not applicable	`v2` or `v3`

A voice keeps the provider it was cloned with for its lifetime, and both kinds work with every endpoint that accepts a voice ID. Cloning does not consume credits with either provider. GET /api/voices/count/ returns the number of cloned voices in the workspace. Because the default provider has no cap, max_count there is a large sentinel value rather than a real limit; the ElevenLabs slot limit is enforced only when you clone with voice_provider: "elevenlabs".

Authorizations

X-API-ID

string

header

required

API ID, from your settings page.

X-API-KEY

string

header

required

API Key, from your settings page.

Body

original_audio_url

string<uri>

required

URL of the original audio used for cloning

Maximum string length: 1000

name

string

Name of the cloned voice

Maximum string length: 255

voice_provider

enum<string>

default:fishaudio

Provider used to clone the voice. fishaudio (default) is unlimited and does not consume voice slots. elevenlabs occupies one of the workspace's voice slots (3 by default, more if purchased). A voice keeps its provider for its lifetime; both kinds work with every endpoint that accepts a voice ID.

elevenlabs - elevenlabs
fishaudio - fishaudio

Available options:

elevenlabs,

fishaudio

Response

201 - application/json

name

string

required

Maximum string length: 255

accents

object[]

required

read-only

Show child attributes

gender

male - Male
female - Female
non_binary - Non Binary

Available options:

male,

female,

non_binary

Get Started

URL to Video

Aurora

Stock AI Avatar

Custom Avatar

Custom Template

Asset Generator

Text Generator

Ad Clone

Text to Speech

AI Ad Template

Image Ad

Link Parser

AI Ad Script

Stock AI Voice

Stock AI Music

Workspace

AI Shorts (Deprecated)

AI Editing (Deprecated)

Product Video (Deprecated)

Choosing a provider

Authorizations

Body

Response

​Choosing a provider

Authorizations

Body

Response

Choosing a provider