{
"id": "tsk_d6405d127eecb513913f7fde",
"status": "completed",
"audioUrl": "https://speakvela.com/v1/files/tsk_d6405d127eecb513913f7fde/audio.mp3?e=1793003653&s=a43833dee28c734fe275725f6f5114e504a3139520f7ad266d3fd0800ba784b8",
"audioUrlExpiresAt": "2026-10-26T08:34:13.000Z",
"durationSec": 4.99,
"characters": 79,
"modelId": "eleven_v3",
"voiceId": "auq43ws1oslv0tO4BDa7",
"voiceName": "Adam Stone - Smooth and Relaxed"
}
curl --location --request GET 'https://zylalabs.com/api/14352/expressive+text+to+speech+api/35973/text+to+speech?text=Welcome to our channel! Today we are going to talk about the history of coffee.&voiceId=auq43ws1oslv0tO4BDa7&modelId=eleven_v3&stability=0.5&similarity=0.75&speed=1&speakerBoost=true&language=en' --header 'Authorization: Bearer YOUR_API_KEY'
{
"id": "tsk_d6405d127eecb513913f7fde",
"status": "completed",
"audioUrl": "https://speakvela.com/v1/files/tsk_d6405d127eecb513913f7fde/audio.mp3?e=1793065256&s=2bb260756b2383d8f95a70336c4e38f9d82130658321d5585f08d31cd79a0ef2",
"audioUrlExpiresAt": "2026-10-27T01:40:56.000Z",
"durationSec": 4.99,
"characters": 79,
"modelId": "eleven_v3",
"voiceId": "auq43ws1oslv0tO4BDa7",
"voiceName": "Adam Stone - Smooth and Relaxed"
}
curl --location --request GET 'https://zylalabs.com/api/14352/expressive+text+to+speech+api/35974/get+speech+result&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"items": [
{
"id": "Gfpl8Yo74Is0W6cPUWWT",
"name": "Max - Elearning and Documentary",
"tags": [
"professional",
"informative_educational"
],
"languages": [
{
"language": "en",
"accent": "american",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJ2b2ljZV9zb3VyY2UiOiJjdXN0b20iLCJ1c2VyX2lkIjoiQ0VaWHhmZENmRWZ5WEQ3eVVOS0lQY3VDS2FCMyIsImZpbGVuYW1lIjoiMWVkMGU2YWYtNTcxYi00YjhlLTlhYTItNzcxNWNmMjRkMDFiLm1wMyIsInRpbWVzdGFtcCI6MTc5MjQ1ODAwMDAwMDAwMH0%3D"
},
{
"language": "pt",
"accent": "brazilian",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJ2b2ljZV9zb3VyY2UiOiJjdXN0b20iLCJ1c2VyX2lkIjoiQ0VaWHhmZENmRWZ5WEQ3eVVOS0lQY3VDS2FCMyIsImZpbGVuYW1lIjoiNWExZGNkZDYtYjk5OS00MmM3LWE1ZDctN2ZkNzZlYmI1ZWQ0Lm1wMyIsInRpbWVzdGFtcCI6MTc5MjQ1ODAwMDAwMDAwMH0%3D"
},
{
"language": "el",
"accent": "el-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImVsIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "hu",
"accent": "hu-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6Imh1IiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "no",
"accent": "no-sørlandsk",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6Im5vIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "no",
"accent": "no-oslo",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6Im5vIiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "hr",
"accent": "hr-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImhyIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "hr",
"accent": "hr-dubrovnik",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImhyIiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "hi",
"accent": "hi-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImhpIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "vi",
"accent": "vi-southern",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InZpIiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "cs",
"accent": "cs-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImNzIiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "sv",
"accent": "sv-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InN2IiwibW9kZWxfaWQiOiJlbGV2ZW5fdHVyYm9fdjJfNSJ9"
},
{
"language": "pl",
"accent": "pl-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InBsIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "ro",
"accent": "ro-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InJvIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "ms",
"accent": "ms-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6Im1zIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "uk",
"accent": "other",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InVrIiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "tr",
"accent": "tr-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InRyIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "ar",
"accent": "ar-modern-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImFyIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "es",
"accent": "es-latin-american",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImVzIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "en",
"accent": "en-american",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImVuIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "nl",
"accent": "nl-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6Im5sIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "de",
"accent": "other",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImRlIiwibW9kZWxfaWQiOiJlbGV2ZW5fbXVsdGlsaW5ndWFsX3YyIn0%3D"
},
{
"language": "de",
"accent": "de-standard",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6ImRlIiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
},
{
"language": "pt",
"accent": "pt-brazilian",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJraW5kIjoidmVyaWZpZWRfbGFuZ3VhZ2UiLCJsYW5ndWFnZSI6InB0IiwibW9kZWxfaWQiOiJlbGV2ZW5fZmxhc2hfdjJfNSJ9"
}
],
"quality": "high",
"description": "A friendly, articulate eLearning voice, great for teaching, documentaries, and explainers",
"previewUrl": "https://speakvela.com/v1/previews/a/Gfpl8Yo74Is0W6cPUWWT.mp3?payload=eyJ2b2ljZV9zb3VyY2UiOiJjdXN0b20iLCJ1c2VyX2lkIjoiQ0VaWHhmZENmRWZ5WEQ3eVVOS0lQY3VDS2FCMyIsImZpbGVuYW1lIjoiMWVkMGU2YWYtNTcxYi00YjhlLTlhYTItNzcxNWNmMjRkMDFiLm1wMyIsInRpbWVzdGFtcCI6MTc5MjQ1ODAwMDAwMDAwMH0%3D",
"gender": "male",
"age": "middle_aged",
"language": "en",
"accent": "american",
"useCase": "informative_educational",
"category": "informative_educational"
},
{
"id": "7b9mYhmnp0y2qSH1FnBL",
"name": "Bunty - Funny Best Friend",
"tags": [
"upbeat",
"characters_animation"
],
"languages": [
{
"language": "hi",
"accent": "standard",
"previewUrl": "https://speakvela.com/v1/previews/g/ZGF0YWJhc2Uvd29ya3NwYWNlL2VkOWIwNWU2MzI0YzQ1NzY4NTQ5MDM1MmU5YTFlYzkwL3ZvaWNlcy83YjltWWhtbnAweTJxU0gxRm5CTC9wM1RINkNJT2lSNmRGMkJYUW10dy5tcDM.mp3"
},
{
"language": "hr",
"accent": "hr-dubrovnik"
}
]
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/14352/expressive+text+to+speech+api/35975/search+voices?pageSize=3' --header 'Authorization: Bearer YOUR_API_KEY'
{
"status": "completed",
"audioUrl": "https://speakvela.com/v1/files/merge/mrg_e10b25a34bb6acb57b011fb9.mp3?e=1793067601&s=14ff857fe9b70bca04dcb8642c28e2bd4d56bb0bb420a87ba16a1e211c533607",
"audioUrlExpiresAt": "2026-10-27T02:20:01.000Z",
"parts": 2,
"durationSec": 11.21
}
curl --location --request GET 'https://zylalabs.com/api/14352/expressive+text+to+speech+api/35976/merge+speech+parts?ids=tsk_d6405d127eecb513913f7fde,tsk_c58203a8821203f352e3f194' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 富有表现力的文本转语音 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
调用文本转语音,传入文本、语音ID和模型ID 请求会等待音频准备好,通常需要10到40秒,并返回完成的MP3文件链接
每次调用最多1000个字符。如果文本较长,将其分割成最多1000个字符的部分,然后按阅读顺序将各部分的ID传递给合并语音部分。您将获得一个MP3,其中所有部分连接在一起,部分之间有短暂的停顿,最多250个部分。
任何来自语音库的公共语音 使用搜索语音通过名称、语言、性别、年龄或口音查找语音 然后将语音ID作为voiceId传递 不支持克隆和私有语音
所选模型支持的每种语言 语言从文本中检测,您也可以使用如en、es或de等ISO 639-1代码通过语言参数设置它
音频网址有效期为7天,无需API密钥,因此您可以直接将其提供给浏览器、音频播放器或其他服务。如果您需要更长时间保存文件,请下载该文件
音频在约50秒内没有准备好 响应有一个ID 请在几秒钟后调用获取语音结果并使用该ID以获取带有MP3链接的相同响应
错误如文本超过1000个字符、未知的声音或拒绝的文本会返回错误代码而不是200,您可以修复请求并重新发送
V3 v4 和 v4 Turbo 其模型 ID 分别为 eleven_v3 eleven_v4 和 eleven_v4_turbo 多语言 v2 Flash v2.5 和 Turbo v2.5 在我们单独的“多语言文本转语音 API”中
每个端点返回JSON数据 文本转语音端点提供音频网址 作业状态 持续时间 字符计数 模型ID 和语音ID 获取语音结果端点为特定语音作业返回类似数据 搜索语音端点返回可用语音的列表 并包含名称 标签 语言 和预览网址 合并语音部分端点返回合成音频网址和关于合并部分的元数据
关键字段包括 `id` (作业标识符)、`status` (作业完成状态)、`audioUrl` (MP3 文件链接)、`audioUrlExpiresAt` (链接的过期时间)、`durationSec` (音频时长)、`characters` (处理的字符数)、`modelId` (使用的语音模型)和 `voiceId` (使用的特定语音) 这些字段帮助用户有效地跟踪和利用生成的音频
文本转语音端点需要参数,如`text`(输入文本)、`voiceId`(选择的声音)和`modelId`(语音模型) 搜索声音端点允许通过`name`(名称)、`language`(语言)、`gender`(性别)、`age`(年龄)和`accent`(口音)进行过滤 合并语音部分端点需要一个`audioIds`列表以指定要合并的MP3文件的顺序 用户可以根据他们的需求自定义请求
响应数据采用JSON格式结构化,具有键值对以便于访问。例如,文本转语音响应在顶层包括字段如`id`、`status`和`audioUrl`。这种组织方式使用户能够快速识别和利用所需信息,例如访问音频文件或检查作业状态
典型的用例包括为电子学习创建音频内容 为视频生成旁白 以及开发需要语音输出的互动应用 用户还可以合并多个音频片段以便于较长的文本 这使其适合于有声读物或演示 表达丰富的语音能力增强了用户在各种应用中的参与感
用户可以通过访问`audioUrl`来下载或串流生成的语音,`status`字段帮助跟踪作业完成情况,而`durationSec`告知用户音频的长度,对于合并音频,`parts`字段指示合并了多少个片段,使用户能够高效管理他们的音频文件
文本到语音端点提供音频生成结果,包括音频链接和作业状态 获取语音结果端点提供特定语音作业的详细信息 搜索声音端点列出了可用的声音及其属性,如语言和口音 合并语音部分端点提供有关合并音频的详细信息,包括其持续时间和部分数量
通过使用先进的语音模型(v3,v4,v4 Turbo)并定期在多样化的数据集上更新和训练,数据的准确性得以保持 API确保生成的声音富有表现力和情感,从而提高生成语音的质量 持续的改进和用户反馈也有助于维护语音合成的高标准