List TTS Models
curl --request GET \
--url https://api.bland.ai/v1/models \
--header 'authorization: <authorization>'{
"models": [
{
"model_id": "BTTS_V2",
"display_name": "V2",
"description": "Current-generation TTS with multilingual output and instant single-sample cloning.",
"sample_rates": [8000, 16000, 24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en", "de", "es", "fr", "hi", "it", "ja", "ko", "nl", "pl", "pt", "ru", "tr", "zh", "ar", "id", "sv"],
"is_recommended": true
},
{
"model_id": "BTTS_V3",
"display_name": "Experimental",
"description": "Showcase clones. Newest model, ships ahead of full V2 feature parity.",
"sample_rates": [24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en"]
},
{
"model_id": "BTTS",
"display_name": "V1",
"description": "Legacy English-only TTS. Retained for backward compatibility, prefer V2 for new integrations.",
"sample_rates": [8000, 16000, 24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en"]
}
]
}
Models
List TTS Models
List the available Bland TTS models and their capabilities.
GET
/
v1
/
models
List TTS Models
curl --request GET \
--url https://api.bland.ai/v1/models \
--header 'authorization: <authorization>'{
"models": [
{
"model_id": "BTTS_V2",
"display_name": "V2",
"description": "Current-generation TTS with multilingual output and instant single-sample cloning.",
"sample_rates": [8000, 16000, 24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en", "de", "es", "fr", "hi", "it", "ja", "ko", "nl", "pl", "pt", "ru", "tr", "zh", "ar", "id", "sv"],
"is_recommended": true
},
{
"model_id": "BTTS_V3",
"display_name": "Experimental",
"description": "Showcase clones. Newest model, ships ahead of full V2 feature parity.",
"sample_rates": [24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en"]
},
{
"model_id": "BTTS",
"display_name": "V1",
"description": "Legacy English-only TTS. Retained for backward compatibility, prefer V2 for new integrations.",
"sample_rates": [8000, 16000, 24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en"]
}
]
}
Overview
Returns the Bland TTS models currently available for synthesis and cloning, with each model’s supported sample rates, language list, and clone eligibility. Use this endpoint to render model pickers, pre-validate a request before calling Speak, or check which engines support cloning before calling Clone Voice. Results are cached for up to 5 minutes.Headers
Your API key for authentication.
Response
Array of available models.
Show Model fields
Show Model fields
Engine identifier. Use this to map a voice’s
service field back to its model.Human-readable name suitable for UI (for example
V1, V2).Short description of the model’s positioning.
Supported audio sample rates in Hz. Pass an
output_format to Speak that matches one of these.Maximum characters per synthesis request supported by the model.
Whether Clone Voice can produce voices on this model.
Language codes supported for synthesis.
true for the model Bland currently recommends for new integrations.{
"models": [
{
"model_id": "BTTS_V2",
"display_name": "V2",
"description": "Current-generation TTS with multilingual output and instant single-sample cloning.",
"sample_rates": [8000, 16000, 24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en", "de", "es", "fr", "hi", "it", "ja", "ko", "nl", "pl", "pt", "ru", "tr", "zh", "ar", "id", "sv"],
"is_recommended": true
},
{
"model_id": "BTTS_V3",
"display_name": "Experimental",
"description": "Showcase clones. Newest model, ships ahead of full V2 feature parity.",
"sample_rates": [24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en"]
},
{
"model_id": "BTTS",
"display_name": "V1",
"description": "Legacy English-only TTS. Retained for backward compatibility, prefer V2 for new integrations.",
"sample_rates": [8000, 16000, 24000, 44100],
"max_characters": 1000,
"can_clone": true,
"languages": ["en"]
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I