Skip to content
API ReferenceEndpoints

Clone a voice

Upload a clean audio sample and receive a reusable voice. Send the request as multipart/form-data.

POST/api/v1/voice-clone

Send the request as multipart/form-data. Cloning is free — it costs zero characters, and every plan includes unlimited clones.

Body · multipart/form-data
audiofileRequired
The voice sample. WAV or MP3, up to 25 MB. A clean 10–30 second recording with no background noise gives the best clone.
namestringRequired
A label for the voice, 2–80 characters. Shown back to you and stored with the clone.
genderstringDefaults to Unspecified
One of Male, Female, Neutral, Unspecified.
languagestringDefaults to en
Two-letter ISO 639-1 code, e.g. en, fr, ar.

Returns

201 Created
successboolean
Always true on success.
dataobject
The new voice.
creditsobject
Your balance after the request. See Credits.
Store the voiceId

It's permanent and reusable — you never need to re-upload the sample to speak in this voice again.

Request
curl -X POST https://www.jsflabs.io/api/v1/voice-clone \
  -H "x-api-key: jsf_your_api_key" \
  -F "audio=@sample.wav" \
  -F "name=Morgan" \
  -F "gender=Female" \
  -F "language=en"
Response201 Created
Response
{
  "success": true,
  "message": "Your voice has been cloned successfully.",
  "data": {
    "voiceId": "jsf_c3BlZWNoaWZ5X3ZvaWNlX2lk",
    "name": "Morgan",
    "language": "en",
    "gender": "Female",
    "sampleUrl": "https://cdn.jsflabs.io/clones/.../sample.wav",
    "createdAt": "2026-08-12T09:20:44.120Z"
  },
  "credits": { "cost": 0, "used": 0, "remaining": 50000, "total": 50000 }
}