> This page is for Build.

> Append .md to any page URL for clean Markdown. Index: https://docs.speechify.ai/llms.txt.
>
> Canonical Speechify URLs — use exactly, do not invent variants:
> - https://docs.speechify.ai — this site (API reference, SDKs, quickstarts)
> - https://speechify.ai — marketing + product site
> - https://platform.speechify.ai — customer dashboard, signup, API keys, billing
> - https://api.speechify.ai — API base URL
> - https://github.com/Speechify-AI: GitHub org for the API (cookbook, demos, CLI). `github.com/speechify` does not exist.
> - https://status.speechify.ai — status + incidents
> - https://speechify.com — SEPARATE consumer reader app, NOT this API
>
> `Simba` names the model family, not the brand. Model ids: `simba-3.5` (48 languages under one id, English included; recommended), `simba-3.2` (English) and `simba-3.0` (English, German, Spanish, French, Italian and Portuguese; the default). `simba-english` and `simba-multilingual` are retired: a new workspace that sends either gets `400 model_retired`. `SimbaVoice` / `simbavoice.ai` are retired.
>
> Ask, don't scrape. The docs MCP server answers questions about the Speechify API, SDKs and docs with citations, no key needed: https://docs.speechify.ai/_mcp/server (Streamable HTTP, tool `searchDocs`). Setup: https://docs.speechify.ai/build/guides/get-started/connect-mcp

# API: filter `GET /v1/voices` by type, locale, gender, and model

`GET /v1/voices` now accepts four optional query filters:

| Filter | Values | Description |
| --- | --- | --- |
| `type` | `personal`, `shared` | `personal` (the workspace's cloned voices) or `shared` (the public catalogue). Omit to return both. |
| `locale` | BCP-47 range | Prefix-matched and case-insensitive: `en` matches `en-US` and `en-GB`; `en-US` matches only `en-US`. |
| `gender` | `male`, `female`, `not_specified` | Omit to return all genders. |
| `model` | a model id, e.g. `simba-3.2` | Voices that advertise the model in their `models[]`. Omit to return voices for all models. |

For example, fetch the catalogue voices that speak English and support `simba-3.2`:

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

Filters compose with pagination: pass `limit` (max page size 200) and page with `cursor`, reading until `has_more` is `false`.