Typecast
SupportGo to API Console
Voices

Recommend Voices

SDK

Use the SDK for safer, faster integration than manual HTTP calls.

SDK guide

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

Authorizations

X-API-KEYstringheaderrequired

API key for authentication. You can obtain an API key from the Typecast API Console.

Query parameters

querystringrequired

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

200Success - Returns recommended voices sorted by scoreapplication/json
scorenumber

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

voice_idstring

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

voice_namestring

Human-readable voice name.

⌘I