tts

Generate speech

Create speech from text using a catalog or owned custom voice. Uses the same character credits and plan limits as the app. Returns a history ID and a temporary audio download URL. Reuse requestId to avoid a second generation.

post/actions/tts_generate

Request

  • Base URL: https://api.voicecheap.ai/v1
  • URL: https://api.voicecheap.ai/v1/actions/tts_generate
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

Idempotency-Keystring uuid

UUID v4 shared across retries of this action. Alternatively pass requestId in the JSON body.

Request body

requestIdstring uuid

UUID v4 for this action. Reuse the same ID with identical arguments on retries.

textstring required
voicestring required

A voice selection ID from voices_list, including clone: IDs for saved custom voices.

inputType'text' | 'pdf'
instructionPreset'default' | 'cheerful' | 'calm' | 'narrator' | 'dramatic' | 'whisper' | 'energetic'
instructionsstring
speednumber
sourceFileNamestring

Response

Completed result or saved request state.

dataunknown required
requestIdstring uuid

Changes

No recorded changes to this operation across all 1 revision of this API.