API Reference
Voices
Read-only catalog of TTS providers and a curated voice roster. It filters by provider only; for search by language, gender, or accent use GET /v1/tts/voices.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Query Parameters
provider?string
Filter to a single provider's voices. Accepts either the routing key (cartesia, xai, alibaba, openai, inworld, elevenlabs) or the catalog suffix form (xai-tts, alibaba-tts, openai-tts).
Response Body
application/json
application/json
{
"voices": [
{
"vendor": "string",
"id": "string",
"name": "string",
"models": [
"string"
]
}
],
"providers": [
{
"key": "string",
"name": "string",
"models": [
"string"
],
"voicesFetchedLive": true,
"source": "BYOK"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Synthesize
Routes the request to the best TTS provider for your intent, with automatic failover. Returns binary audio. The `Content-Type` header (mirrored in `X-Speko-Audio-Format`) tells you the format.
Voice library
Search every indexed voice by description, similarity, or filters, and read one voice's index entry.