POST
/
v1
/
ai
/
tts
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",
  "return_type": "url"
})

{
  "url": "https://jigsawstack-temp.b1e91a466694ad4af04df5d05ca12d93.r2.cloudflarestorage.com/temp/664293fa-77ec-44d2-8f2e-35ca61683f15.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=7b9a19349842b7b1a9e4c2e19f05b232%2F20250623%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250623T154001Z&X-Amz-Expires=604800&X-Amz-Signature=b0235ffdb996d9a132061c4273cfcda9b1bc2d5659084009338e2c11e4a02510&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "_usage": {
        "input_tokens": 6,
        "output_tokens": 38,
        "inference_time_tokens": 612,
        "total_tokens": 656
  }
}

​
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

​
text
string
required

The text to generate speech from. Character Limits: - Standard TTS: 5-1,500 characters - Voice Cloning TTS: 5-500 characters

​
accent
string
default:"en-US-female-27"

Speaker voice accent. Not required if using voice cloning. Over 700 different voices across multiple languages are available. See the Speaker Voice Accents documentation for the complete list.

​
voice_clone_id
string

The unique identifier for a previously cloned voice. When provided, the API will generate speech using this pre-cloned voice profile instead of creating a new one.

​
return_type
string

The specified return type for the response

  • url
  • base64
  • binary

For best results, the accent should match the language of the text for accurate pronunciation, even when using a cloned voice. You can use either a built-in voice by specifying just the accent, or provide both an accent and a voice_clone_id to use a previously cloned voice.

​
x-api-key
string
required

Your JigsawStack API key

​
Response

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

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",
  "return_type": "url"
})

{
  "url": "https://jigsawstack-temp.b1e91a466694ad4af04df5d05ca12d93.r2.cloudflarestorage.com/temp/664293fa-77ec-44d2-8f2e-35ca61683f15.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=7b9a19349842b7b1a9e4c2e19f05b232%2F20250623%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20250623T154001Z&X-Amz-Expires=604800&X-Amz-Signature=b0235ffdb996d9a132061c4273cfcda9b1bc2d5659084009338e2c11e4a02510&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
  "_usage": {
        "input_tokens": 6,
        "output_tokens": 38,
        "inference_time_tokens": 612,
        "total_tokens": 656
  }
}