HEhedra-labs
Models

Search Model Voices

Changed on

The voices this model accepts, ranked against a description — the whole shared library, including the voices the listing does not return.

get/models/{model}/voices/search

Request

  • Base URL
    https://api.hedra.com/v3
  • Auth
    • API key in header Authorization
    • or HTTP bearer

Path parameters

modelstring required

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

Query parameters

qstring 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.

limitinteger

Maximum voices to return. Applies to the whole response.

gender'male' | 'female'

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.

Only voices curated with this gender.

languagestring nullable

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

Response

Successful Response

next_cursorstring nullable 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.

Changes