Skip to main content
GET
cURL

Authorizations

​
Authorization
string
header
required

Primary scheme: Authorization: Key <key_id>:<secret>.

Path Parameters

​
model
string
required

The model's public id (GET /v3/models).

Query Parameters

​
q
string
required

What the voice should sound like, in plain words — "warm british narrator", "energetic young announcer". Matched against the whole library for this model's provider, not just the voices GET /v3/models/{model}/voices returns.

Required string length: 1 - 200
​
limit
integer
default:20

Maximum voices to return. Applies to the whole response.

Required range: 1 <= x <= 50
​
gender
enum<string> | null

Only voices curated with this gender. The gender curation label, as a voice search filter.

Two members because the label carries exactly two values across every provider; published as an enum so a generated SDK types the filter rather than taking any string and failing at the boundary.

Available options:
male,
female
​
language
string | null

Only voices curated for this language, as an ISO 639-1 two-letter code (en, es, fr).

Maximum string length: 8

Response

Successful Response

​
data
VoiceSummary · object[]
required

This page of items.

​
next_cursor
string | null
required

Opaque cursor for the next page, or null when this response completes the list. Always present. Endpoints that serve the whole collection at once always return null.