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 /v2/voices or GET /v2/voices/{voice_id} when you need detailed metadata such as supported models, emotions, gender, age, or use cases for the recommended voices.
Authorizations
API key for authentication. You can obtain an API key from the Typecast API Console.
Query Parameters
Text description. Describe the desired style, mood, language, use case, or content context with keywords or sentences.
1 - 500Maximum 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.
1 <= x <= 10Response
Success - Returns recommended voices sorted by score
10Typecast voice identifier with the tc_ prefix. Use this value as voice_id in text-to-speech requests.
"tc_60e5426de8b95f1d3000d7b5"
Human-readable voice name.
"Olivia"
Recommendation relevance score. Higher values indicate a stronger match for the query.
0.92