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-cloneSend the request as multipart/form-data. Cloning is free — it costs zero characters, and every plan includes unlimited clones.
Body · multipart/form-data
audiofileRequiredThe voice sample. WAV or MP3, up to 25 MB. A clean 10–30 second recording with no background noise gives the best clone.
namestringRequiredA label for the voice, 2–80 characters. Shown back to you and stored with the clone.
genderstringDefaults to UnspecifiedOne of
Male, Female, Neutral, Unspecified.languagestringDefaults to enTwo-letter ISO 639-1 code, e.g.
en, fr, ar.Returns
201 Created
successbooleanAlways
true on success.dataobjectThe new voice.
creditsobjectYour 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 }
}