API ReferenceCore concepts
Voice IDs
Cloning returns a portable, permanent voice identifier prefixed with jsf_.
Every voice has one portable ID. Pass it straight into text to speech as voice_id. There are two kinds:
| Kind | Looks like | Where you get it | Can delete? |
|---|---|---|---|
| Default voice | jsf_default_aaliya | List voices | No |
| Cloned voice | jsf_c3BlZWNoaWZ5X3ZvaWNlX2lk | Clone a voice | Yes, with Delete a voice |
Default voices
1,100+ ready-made voices in 45 languages, available to every account. Use them without cloning anything.
Cloned voices
Created from your own sample and private to your account. Another account can't use or see them.
Rules for both
- Treat the value as opaque. Don't parse or modify it.
- It's permanent. Store it once and reuse it, unless you delete a cloned voice.
- A value that doesn't start with
jsf_is rejected withINVALID_VOICE_ID. A well-formed ID that doesn't exist on your account returnsVOICE_NOT_FOUND.
