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.
X-API-KEYstringheaderrequiredAPI key for authentication. You can obtain an API key from the Typecast API Console.
querystringrequiredText description. Describe the desired style, mood, language, use case, or content context with keywords or sentences.
countintegerMaximum 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.
application/jsonvoice_idstringTypecast voice identifier with the tc_ prefix. Use this value as voice_id in text-to-speech requests.
voice_namestringHuman-readable voice name.
scorenumberRecommendation relevance score. Higher values indicate a stronger match for the query.