Text-to-Speech API

The text-to-speech API turns text into natural-sounding audio from a single request. This page takes you from an API key to saved audio in a few minutes, then points to the streaming, voice, and SSML guides once you have the basics working.

$
export SPEECHIFY_API_KEY="your-api-key-here"

$
pip install speechify-api

1
curl -X POST https://api.speechify.ai/v1/audio/speech \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json" \
4
     -d '{
5
  "input": "Hello! This is the Speechify text-to-speech API.",
6
  "voice_id": "geffen_32",
7
  "audio_format": "mp3",
8
  "model": "simba-3.2"
9
}'

1
{
2
  "audio_data": "example",
3
  "audio_format": "wav",
4
  "billable_characters_count": 10,
5
  "speech_marks": {
6
    "chunks": [
7
      {}
8
    ],
9
    "end": 1,
10
    "end_time": 1,
11
    "start": 1,
12
    "start_time": 1,
13
    "type": "example",
14
    "value": "example"
15
  }
16
}

Request essentials

The speech endpoint takes a small, predictable set of fields.

Choose a voice

Call GET /v1/voices to list the voices your workspace can use - the shared catalog plus any voices you’ve cloned - then pass a voice’s id as the voice_id:

1
curl -G https://api.speechify.ai/v1/voices \
2
     -H "Authorization: Bearer <token>" \
3
     -d locale=en \
4
     -d model=simba-3.2

Popular built-in voices: george, henry, carly, sabrina.

Filter the list

Four optional query parameters narrow the results. Combine them freely.

For example, list the catalog voices that speak English and support simba-3.2:

$
curl "https://api.speechify.ai/v1/voices?type=shared&locale=en&model=simba-3.2" \
>
  -H "Authorization: Bearer $SPEECHIFY_API_KEY"

Page through the catalog

GET /v1/voices supports cursor pagination. For callers using API version 2026-07-16 or later, it returns a page even when limit is omitted (default page size 50, max 200). Each response carries a next_cursor and a has_more flag. To read the full catalog, request the next page with cursor set to the previous response’s next_cursor, and stop once has_more is false. Don’t assume a single response holds every voice - always follow has_more.

$
# First page
$
curl "https://api.speechify.ai/v1/voices?limit=100" \
>
  -H "Authorization: Bearer $SPEECHIFY_API_KEY"
$
$
# Next page, using next_cursor from the previous response
$
curl "https://api.speechify.ai/v1/voices?limit=100&cursor=NEXT_CURSOR" \
>
  -H "Authorization: Bearer $SPEECHIFY_API_KEY"

Narrow the list

GET /v1/voices accepts optional query filters, applied before pagination so pages stay full. Combine them to return only the voices you care about:

For example, return only English cloned voices that work on simba-3.2:

$
curl "https://api.speechify.ai/v1/voices?type=personal&locale=en&model=simba-3.2" \
>
  -H "Authorization: Bearer $SPEECHIFY_API_KEY"

The full catalog is returned in one response by default. Pagination is opt-in: pass limit (then cursor from the previous response) to page through the list while has_more is true, up to a page size of 200.

Next steps