Skip to content
API ReferenceReference

Error codes

The full set of error codes, grouped by cause. Codes are stable — safe to match on.

The full set of error codes, grouped by what caused them. Codes are stable, so they're safe to match on in your integration.

Authentication & access

HTTPCodeMeaning
401MISSING_API_KEYNo x-api-key header was sent.
401INVALID_KEY_FORMATThe key doesn't start with jsf_ or is too short.
401INVALID_API_KEYThe key doesn't match any account.
403SUBSCRIPTION_INACTIVEThe account's subscription is turned off.
403KEY_EXPIREDThe key's expiry date has passed.
503AUTH_SERVICE_ERRORAuthentication was briefly unavailable. Retry shortly.

Request & quota

HTTPCodeMeaning
429RATE_LIMITEDOver the limit for this endpoint. Wait Retry-After seconds.
400INVALID_JSONText-to-speech body wasn't valid JSON.
400INVALID_CONTENT_TYPEClone body wasn't multipart/form-data.
422VALIDATION_ERROROne or more fields or query parameters are invalid. See fields.
402INSUFFICIENT_CHARACTERSNot enough character balance for this request.
402UPGRADE_REQUIREDVoice cloning needs a plan with at least 10,000 available characters.
405METHOD_NOT_ALLOWEDThe endpoint doesn't accept this HTTP method.

Voices

HTTPCodeMeaning
400INVALID_VOICE_IDThe voice_id is not a valid jsf_ ID.
404VOICE_NOT_FOUNDThe voice doesn't exist, or isn't on your account.
403CANNOT_DELETE_DEFAULT_VOICEDefault voices can't be deleted.
422VOICE_UNSUPPORTEDThis voice has no stored sample. Clone it again.
503VOICE_LOOKUP_FAILEDVoices couldn't be loaded. Retry shortly.
500DELETE_FAILEDThe voice couldn't be deleted. Retry.

Cloning

HTTPCodeMeaning
422AUDIO_REJECTEDThe sample couldn't be processed. Use a clearer 10–30s recording.
413AUDIO_TOO_LARGEThe sample exceeds the size limit.
429CLONING_CAPACITYThe cloning engine is momentarily at capacity. Retry soon.
503CLONING_SERVICE_DOWNThe cloning engine is temporarily unavailable.
500SAMPLE_SAVE_FAILEDYour sample couldn't be stored. Retry.
502CLONING_FAILEDCloning failed unexpectedly. Retry.

Text to speech

HTTPCodeMeaning
422GENERATION_REJECTEDThe engine couldn't process this text or voice.
503ENGINE_UNAVAILABLEGeneration is temporarily unavailable. Retry shortly.
503MODEL_UNAVAILABLEThe requested model is temporarily unavailable. Try jsf_fi.
504GENERATION_TIMEOUTGeneration took too long. Try shorter text.
502GENERATION_FAILEDGeneration failed unexpectedly. Retry.
502AUDIO_SAVE_FAILEDAudio was generated but couldn't be stored. Retry.

Server

HTTPCodeMeaning
500DB_SAVE_FAILEDThe voice was created but couldn't be saved. Contact support with the returned reference.
500INTERNAL_ERRORAn unexpected server error. Retry, then contact support.