API ReferenceEndpoints
List voices
GET
/api/v1/voicesSend a GET request with optional query parameters. Listing voices is free and doesn't cost any characters.
Every default voice has an ID that starts with jsf_default_. Pass it as voice_id to Text to speech.
Query parameters
languagestringISO 639-1 code, e.g.
en, ur, ar, hi.genderstringmale or female.localestringFull locale, e.g.
en-GB, ur-IN.searchstringMatches the voice name or ID. Up to 80 characters.
pagenumberDefaults to 1Page number, starting at 1.
limitnumberDefaults to 50Voices per page, 1 to 200.
Returns
200 OK
successbooleanAlways
true on success.dataarrayThe voices on this page.
paginationobjectpage, limit, total, total_pages and has_more.filtersobjectThe filters that were applied.
languagesarrayEvery available language with its
code, name and voice count. Use it to build a language dropdown.Fetch the whole catalog
Use limit=200 and increase page until has_more is false. The catalog rarely changes, so cache it on your side.
Request
curl "https://www.jsflabs.io/api/v1/voices?language=ur&gender=female" \
-H "x-api-key: jsf_your_api_key"Response200 OK
Response
{
"success": true,
"data": [
{
"voice_id": "jsf_default_aaliya",
"name": "Aaliya",
"gender": "female",
"language": "ur",
"language_name": "Urdu",
"locale": "ur-IN",
"type": "default",
"provider": "jsf-labs"
}
],
"pagination": { "page": 1, "limit": 50, "total": 20, "total_pages": 1, "has_more": false },
"filters": { "language": "ur", "locale": null, "gender": "female", "search": null },
"languages": [
{ "code": "ar", "name": "Arabic", "count": 5 },
{ "code": "ur", "name": "Urdu", "count": 39 }
]
}