Voices

Recommend Voices

This API recommends the best Typecast voices based on text descriptions.

Instead of manually searching for a specific voice_id, you can find the perfect voice by simply inputting keywords or sentences describing the desired style, mood, language, or use case. The response is sorted by recommendation score, so you can pass the top candidate directly to text-to-speech endpoints such as POST /v1/text-to-speech.

The response includes only voice_id, voice_name, and score. Use GET /v3/voices or GET /v3/voices/{voice_id} when you need detailed metadata such as supported models, emotions, gender, age, or use cases for the recommended voices.

get/v1/voices/recommendations

Request

  • Base URL: https://api.typecast.ai
  • URL: https://api.typecast.ai/v1/voices/recommendations
  • Auth: API key in header X-API-KEY

Query parameters

querystring required

Text description. Describe the desired style, mood, language, use case, or content context with keywords or sentences.

countinteger

Maximum number of recommended voices to return after filtering. Must be between 1 and 10. Fewer than count voices may be returned when there are not enough matching candidates.

Response

Success - Returns recommended voices sorted by score

scorenumber required

Recommendation relevance score. Higher values indicate a stronger match for the query.

voice_idstring required

Typecast voice identifier with the tc_ prefix. Use this value as voice_id in text-to-speech requests.

voice_namestring required

Human-readable voice name.

Example response

[
  {
    "score": 0.92,
    "voice_id": "tc_60e5426de8b95f1d3000d7b5",
    "voice_name": "Olivia"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.