Create a Voice Clone

POST

https://api.smallest.ai/waves/v1/voice-cloning

POST

/waves/v1/voice-cloning

import requests
url = "https://api.smallest.ai/waves/v1/voice-cloning"
files = { "file": "open('[object Object]', 'rb')" }
payload = {
    "accent": "{
  \"type\": \"json\"
}",
    "description": "{
  \"type\": \"json\"
}",
    "displayName": "{
  \"type\": \"json\",
  \"value\": \"my-custom-voice\"
}",
    "language": "{
  \"type\": \"json\"
}",
    "model": "{
  \"type\": \"json\"
}",
    "tags": "{
  \"type\": \"json\"
}"
}
headers = {"Authorization": "Bearer <BearerAuth>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.json())

{
  "message": "Voice clone created successfully",
  "data": {
    "voiceId": "voice_dLP5T67Qw7",
    "displayName": "string",
    "model": "string",
    "status": "pending",
    "language": "string",
    "audioFileNames": [
      "string"
    ],
    "createdAt": "2024-01-15T09:30:00Z",
    "organizationId": "string",
    "samples": [
      {
        "text": "string",
        "audioUrl": "string"
      }
    ]
  }
}

Create an instant voice clone in a single call. Defaults to lightning-v3.1.

Authentication

AuthorizationBearer

API key authentication. Include your key as Authorization: Bearer YOUR_API_KEY. Access tokens are not accepted on this endpoint.

Request

This endpoint expects a multipart form containing a file.

displayNamestringRequired1-500 characters

Human-readable name for the voice clone.

filefileRequired

Audio file to clone from. Supported MIME types: audio/mpeg, audio/mpeg-3, audio/wav, audio/wave, audio/webm, video/webm, audio/mp4, video/mp4. Maximum size: 5 MB.

descriptionstringOptional

Optional longer description for the voice clone.

accentstringOptional

Optional accent tag (e.g. "general", "indian").

tagsstringOptional

Optional comma-separated list of tags. Server splits on commas and trims whitespace ("en, tone-test" → ["en", "tone-test"]).

languageenumOptional

Primary language the clone will be used for. Optional, but strongly recommended — set it to the language of your reference audio. The TTS request's language should also match this code; setting it now avoids silent language mismatches at inference time.

Must be one of the languages supported by lightning-v3.1. The server validates and rejects unsupported codes with a 400.

modelenumOptionalDefaults to lightning-v3.1

Voice cloning model. Defaults to lightning-v3.1. Pass lightning-v3.1-pro to clone onto the premium Pro pool. lightning-v2 is accepted by the schema for historical reasons but is deprecated - the server returns 400 with "Voice cloning for lightning-v2 is deprecated. Please use lightning-v3.1".

Allowed values:

Response

Voice clone created. Includes pre-generated sample clips of the new voice.

messagestringOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error