API ReferenceModels

List Models

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_…’.

Headers

Speechify-VersionstringOptional

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-Limitinteger

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-Remaininginteger

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

RateLimit-Resetinteger

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