SMsmallest-inc
Voice Cloning

Create a voice clone

Changed on

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

post/waves/v1/voice-cloning

Request

  • Base URL
    https://api.smallest.ai
  • URL
    https://api.smallest.ai/waves/v1/voice-cloning
  • Auth
    HTTP bearer

Request body multipart/form-data

displayNamestring required

Human-readable name for the voice clone.

filestring binary required

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.

descriptionstring

Optional longer description for the voice clone.

accentstring

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

tagsstring

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

language'en' | 'hi' | 'mr' | 'kn' | 'ta' | 'bn' | 'gu' | 'de' | 'fr' | 'es' | 'it' | 'pl' | 'nl' | 'ru' | 'ar' | 'he' | 'sv' | 'ml' | 'te' | 'pt' | 'pa' | 'or'

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.

model'lightning-v3.1' | 'lightning-v3.1-pro'

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".

Example request

{
  "displayName": "my-custom-voice",
  "tags": "english,friendly",
  "language": "en"
}

Response

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

messagestring

Example response

{
  "message": "Voice clone created successfully",
  "data": {
    "voiceId": "voice_dLP5T67Qw7"
  }
}

Changes

  • 14c6d876f525Revision changes
    • breaking

      request property was restricted to a list of enum values

    • info

      added the new ar enum value to the request property

    • info

      added the new bn enum value to the request property

    • info

      added the new de enum value to the request property

    • info

      added the new en enum value to the request property

    • info

      added the new es enum value to the request property

    • info

      added the new fr enum value to the request property

    • info

      added the new gu enum value to the request property

    • info

      added the new he enum value to the request property

    • info

      added the new hi enum value to the request property

    • info

      added the new it enum value to the request property

    • info

      added the new kn enum value to the request property

    • info

      added the new ml enum value to the request property

    • info

      added the new mr enum value to the request property

    • info

      added the new nl enum value to the request property

    • info

      added the new or enum value to the request property

    • info

      added the new pa enum value to the request property

    • info

      added the new pl enum value to the request property

    • info

      added the new pt enum value to the request property

    • info

      added the new ru enum value to the request property

    • info

      added the new sv enum value to the request property

    • info

      added the new ta enum value to the request property

    • info

      added the new te enum value to the request property

  • de9bfd4a4458Revision changes
    • info

      added the new lightning-v3.1-pro enum value to the request property