List Models | SpeechifyAI API

{
  "models": [
    {
      "id": "simba-3.0",
      "name": "Simba 3.0",
      "default": true,
      "recommended": false,
      "deprecated": false,
      "description": "Streaming-native model serving both English and multilingual synthesis under one id: English, German, Spanish, French, Italian and Portuguese, routed by the request `language`. The default when a request omits `model`.",
      "languages": [
        "en",
        "de-DE",
        "es-ES",
        "es-MX",
        "fr-FR",
        "it-IT",
        "pt-BR"
      ],
      "endpoints": [
        "/v1/audio/speech",
        "/v1/audio/stream",
        "/v1/audio/stream/with-timestamps"
      ],
      "english_voices_only": false,
      "curated_voices": false
    },
    {
      "id": "simba-3.2",
      "name": "Simba 3.2",
      "default": false,
      "recommended": true,
      "deprecated": false,
      "description": "Streaming-native model with the lowest time-to-first-byte and richest expressivity, English only today. Serves every English voice in the catalog, your workspace's own cloned voices included. Use `simba-3.0` for any other language.",
      "languages": [
        "en"
      ],
      "endpoints": [
        "/v1/audio/speech",
        "/v1/audio/stream",
        "/v1/audio/stream/with-timestamps"
      ],
      "english_voices_only": true,
      "curated_voices": false
    }
  ],
  "dialogue_models": [
    {
      "id": "simba-dialogue-1.0",
      "name": "Simba Dialogue 1.0",
      "default": true,
      "recommended": false,
      "deprecated": false,
      "description": "Multi-speaker model that renders a speaker-attributed script as one conversation with natural turn-taking.",
      "languages": [
        "en"
      ],
      "endpoints": [
        "/v1/audio/dialogue"
      ],
      "english_voices_only": true,
      "curated_voices": false
    }
  ]
}

List the text-to-speech models available for synthesis. Drive a model picker from this response, then pass a model id as the model parameter to POST /v1/audio/speech or /v1/audio/stream. The response marks the default model (used when a request omits model), the routes each model may be passed to, and which voices it accepts. Multi-speaker models arrive in a separate dialogue_models array because they are valid only on POST /v1/audio/dialogue. Returns the full set in a single response: the model catalog is static platform reference data, so it is intentionally not paginated.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. 'Bearer sk_...'.

Response headers

Speechify-Request-IdstringOptional

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends a Speechify-Request-Id request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests

it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the request_id field in the error envelope.

The legacy alias X-Request-ID carries the same value and is still accepted on requests, until 2027-07-24. Prefer the un-prefixed name (RFC 6648).

RateLimit-LimitintegerOptional

Request-rate budget: the maximum number of requests in the current window (the bucket capacity). The IETF-draft un-prefixed name; the legacy alias X-RateLimit-Limit carries the same value. Rides every response.

RateLimit-RemainingintegerOptional

Request-rate budget: requests left in the current window. Legacy alias: X-RateLimit-Remaining.

RateLimit-ResetintegerOptional

Request-rate budget: integer delta-seconds until the window fully refills (same unit as Retry-After). Legacy alias: X-RateLimit-Reset.

Response

The available text-to-speech models.

modelslist of objects

The models selectable on the single-utterance synthesis endpoints.

dialogue_modelslist of objects

The multi-speaker models selectable on POST /v1/audio/dialogue. Disjoint from models: a dialogue model consumes a speaker-attributed script rather than one utterance, so it is rejected on the single-utterance endpoints and vice versa. Its default marks the model that endpoint resolves to when a request omits model, independently of the models default.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

Authentication

Headers

Response headers

Response

Errors