> 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.2` (English, recommended) 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

## SDK: New Typescript SDK

We've published a new Typescript SDK. Try it out:

```bash
npm install @speechify/api
```

Together with the release, the old `@speechify/api-sdk` package is now deprecated.

### Migrating from `@speechify/api-sdk`

<Warning>
  The JWT-based authentication endpoint has been deprecated.
  This means that the auto-refresh token feature has also been removed in the new SDK.
</Warning>

<Info>
   - How to call individual endpoints is available in the [API Explorer](https://docs.speechify.ai/build/api-reference/v1/audio/speech/~explorer). Switch to the Typescript SDK tab to see the snippet.
   - The full implementation of the new SDK is available in the [GitHub repository](https://github.com/speechify-ai/sdk-typescript).
</Info>

### Quick Start Guide

<Steps>
  ### Install the SDK
  Install the package using npm:
  ```bash
  npm install @speechify/api
  ```

  ### Initialize the Client
  Import the SDK and create a new client instance:
  ```typescript
  import { SpeechifyClient } from "@speechify/api";

  // API Key can also be set as an environment variable SPEECHIFY_API_KEY
  const client = new SpeechifyClient({ token: "your-api-key" });
  ```

  ### Fetch Available Voices
  Get a list of all available voices:
  ```typescript
  const voices = await client.tts.voices.list();
  ```

  ### Generate Speech
  Create a new speech synthesis request using a voice:
  ```typescript
  const result = await client.tts.audio.speech({
    voiceId: voices[0].id,
    input: "Hello, world!",
  });
  ```

  ### Save the Audio
  This is now an additional required step since the SDK only returns the raw audio data i.e. a string representing the base64 encoded bytes.
  Convert the audio data and save it to a file:
  ```typescript
  const audioData = result.audioData;
  const audioBuffer = Buffer.from(audioData, "base64");

  // Write the binary data to a file
  fs.writeFileSync("speech.mp3", audioBuffer);
  ```
</Steps>

## API: Deprecated `POST /v1/auth/token` endpoint

The `POST /v1/auth/token` endpoint is now deprecated. We will only support API Key authentication moving forward.

---
<small>2026-08-14: SDK repo moved to [speechify-ai/sdk-typescript](https://github.com/speechify-ai/sdk-typescript)</small>