puter.ai.txt2speech.listEngines()
Websites Puter Apps Node.js Workers
Returns the TTS engines (models) available from a given provider, including pricing metadata where available.
Syntax
puter.ai.txt2speech.listEngines()
puter.ai.txt2speech.listEngines(provider)
puter.ai.txt2speech.listEngines(options)
Parameters
provider (String) (optional)
A provider name to query. When passed as a string, this is shorthand for { provider }. Defaults to 'aws-polly'.
Accepted values: 'aws-polly', 'openai', 'elevenlabs', 'gemini', 'xai'
Common aliases are also accepted (e.g. 'eleven', 'google', 'grok').
options (Object) (optional)
| Option | Type | Description |
|---|---|---|
provider |
String |
TTS provider to query. Defaults to 'aws-polly' |
Return value
A Promise that resolves to an array of engine objects. Each object contains:
| Field | Type | Description |
|---|---|---|
id |
String |
Engine/model identifier |
name |
String |
Human-readable engine name |
provider |
String |
Provider this engine belongs to |
pricing_per_million_chars |
Number |
Cost per million characters (may be absent) |
Example response:
[
{
"id": "gpt-4o-mini-tts",
"name": "GPT-4o Mini TTS",
"provider": "openai",
"pricing_per_million_chars": 12
},
{
"id": "tts-1",
"name": "TTS-1",
"provider": "openai"
}
]
Examples
List engines for a specific provider
<html>
<body>
<script src="https://js.puter.com/v2/"></script>
<script>
(async () => {
const engines = await puter.ai.txt2speech.listEngines('openai');
puter.print('OpenAI TTS engines:');
for (const engine of engines) {
puter.print(` ${engine.id} - ${engine.name}`);
}
})();
</script>
</body>
</html>
List engines using options object
const engines = await puter.ai.txt2speech.listEngines({ provider: 'elevenlabs' });
for (const engine of engines) {
console.log(engine.id, engine.name);
}