Skip to navigation

List Catalog Provider Model Voices

List platform voices available for a specific provider and model.

Returns a paginated list of voices from the platform catalog (system workspace) that declare support for the given model. A voice can appear under multiple models when its supported_models list includes more than one entry; voices with no supported models are excluded from all model listings.

Voices are restricted to the officially supported locales, judged against THIS model: a voice whose official locale lives only on a sibling model is not listed here, and supported_languages carries only official locales. A voice for which the provider supplied no authoritative locale data for this model is excluded too. The voice_count on the model card that links here counts the same population.

Each voice includes gender, age, accent, supported locales, and a short-lived presigned preview_url for the audio sample — do not cache these URLs across sessions. The response pagination.total field reflects the total match count for the provider/model pair.

For the workspace voice picker (which merges platform and workspace-scoped voices and supports favorite/similarity filtering), use GET /voices with ?provider= and ?model= query parameters instead.

Returns 404 if the provider or model is not recognized or is not available to your account.

Authentication

AuthorizationBearer
Clerk JWT token
OR
AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

providerstringRequired
modelstringRequired

Headers

X-Workspace-Idstring or nullOptional

Query parameters

offsetintegerOptional>=0Defaults to 0

Zero-based pagination offset.

limitintegerOptional1-100Defaults to 20

Page size (max 100).

Response

Successful Response
datalist of objects
metaobject
paginationobject
PaginationMeta variant for endpoints that compute an unpaginated total.

Errors

404
Not Found Error
422
Unprocessable Entity Error