Text to Speech

​

Overview

The Text to Speech API converts written text into lifelike speech with options for:

• Multiple languages and accents (700+ different voices)
• Voice cloning from audio samples
• High-quality, natural-sounding output

​

Request Parameters

​

Body

​

Header

​

Response

The API returns the generated audio file directly in the response body as binary data, typically in MP3 format.

​

Popular Voice Accents

Here’s a selection of commonly used voice accents:

​

English Voices

• en-US-female-27 (Default) - American English, Female 27
• en-US-male-24 - American English, Male 24
• en-GB-female-2 - British English, Female 2
• en-GB-male-2 - British English, Male 2
• en-AU-female-2 - Australian English, Female 2
• en-IN-female-3 - Indian English, Female 3

​

Other Languages

• fr-FR-female-12 - French, Female 12
• de-DE-female-1 - German, Female 1
• es-ES-female-9 - Spanish (Spain), Female 9
• es-MX-female-12 - Spanish (Mexico), Female 12
• ja-JP-female-14 - Japanese, Female 14
• zh-CN-female-15 - Chinese (Mandarin), Female 15

​

Voice Cloning

Voice cloning allows you to generate speech that mimics a specific voice from an audio sample. This is useful for creating custom voices for applications, personalized assistants, or consistent brand voices.

​

Using Voice Cloning

1. Provide a clear audio sample using either:

   • speaker_clone_url - Direct URL to an audio file
   • speaker_clone_file_store_key - Key to a file in Jigsawstack storage

2. Provide the text you want to convert to speech (maximum 500 characters)

3. The API will analyze the sample and generate speech with similar voice characteristics

​

Best Practices for Voice Cloning

• Use high-quality audio samples with minimal background noise
• Samples should be clear speech without music or other voices
• Longer samples (30+ seconds) provide better voice modeling
• For best results, the sample should contain speech similar in tone and style to your desired output

​

Getting Available Voices

To retrieve the complete list of available voices programmatically:

const voices = await jigsawstack.audio.speaker_voice_accents();
console.log(voices);

voices = jigsawstack.audio.speaker_voice_accents()
print(voices)

​

Common Use Cases

• Content Creation: Generate voiceovers for videos, podcasts, and presentations
• Accessibility: Convert written content to audio for visually impaired users
• Interactive Applications: Build voice assistants, language learning apps, and interactive experiences
• Customer Service: Create automated voice responses for customer service systems
• Localization: Translate and vocalize content in multiple languages
• Personalization: Clone a specific voice for consistent brand messaging

import { JigsawStack } from "jigsawstack";

const jigsaw = JigsawStack({ apiKey: "your-api-key" });

const response = await jigsaw.audio.text_to_speech({
  "text": "Hello, world!",
  "accent": "en-US-female-27"
})