curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "elevenlabs/tts/turbo-v2.5",
"input": {
"similarity_boost": 0.75,
"style": 0,
"apply_text_normalization": "auto",
"text": "Almost there. Fold the top corner down until it meets the center crease. Now press along the edge with your fingertip. That's it. Turn the paper over, and we'll make the next fold together.",
"voice": "Rachel",
"language_code": "en",
"speed": 1.05,
"stability": 0.5,
"timestamps": false
}
}
EOF{
"code": 200,
"data": {
"task_id": "QKTPQMIP4AZY1LGE",
"status": "running",
"created_time": "2026-09-27T10:51:18"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}ElevenLabs
ElevenLabs TTS Turbo v2.5
使用 ElevenLabs Turbo v2.5 生成语音旁白，可调节语速、演绎风格和音色相似度，并可选返回文本对齐数据。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "elevenlabs/tts/turbo-v2.5",
"input": {
"similarity_boost": 0.75,
"style": 0,
"apply_text_normalization": "auto",
"text": "Almost there. Fold the top corner down until it meets the center crease. Now press along the edge with your fingertip. That's it. Turn the paper over, and we'll make the next fold together.",
"voice": "Rachel",
"language_code": "en",
"speed": 1.05,
"stability": 0.5,
"timestamps": false
}
}
EOF{
"code": 200,
"data": {
"task_id": "QKTPQMIP4AZY1LGE",
"status": "running",
"created_time": "2026-09-27T10:51:18"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- elevenlabs/tts/turbo-v2.5 - 将文本转换为语音。
功能
- 将文本转换为语音。
- 可在生成音频的同时请求时间戳。
- 使用
voice选择音色，使用language_code指定朗读语言。
高级参数
在请求根级设置model 和可选的 callback_url。所有工作流程参数（包括输出选项）都放在 input 中。
以下参数定义该模型的 input 对象。
音色
voice：可选。选择音色名称或兼容的音色 ID。字符串。默认：Rachel。
稳定性
stability：可选。控制音色稳定性。数值0到1。默认：0.5。
相似度增强
similarity_boost：可选。控制音色相似度。数值0到1。默认：0.75。
风格
style：可选。设置音色风格强度。数值0到1。默认：0。
语速
speed：可选。设置语速。数值0.7到1.2。默认：1。
时间戳
timestamps：可选。在返回音频的同时请求时间戳信息。使用true或false。默认：false。
前文
previous_text：可选。提供前文作为语音上下文。字符串，也可为null。
后文
next_text：可选。提供后文作为语音上下文。字符串，也可为null。
语言代码
language_code：可选。使用 ISO 639-1 代码设置朗读语言，例如en、fr、de、ja、vi、hu或no。也可为null。
文本规范化
apply_text_normalization：可选。控制朗读前如何处理数字、日期和货币：auto自动选择是否规范化，on启用规范化，off直接朗读所给文本。默认：auto。
文本
text：必填。要朗读的文本。去除首尾空白后长度为 1-40,000 个 Unicode 字符，且至少包含一个可见字符。
输出文件
- 读取返回的
files数组中的每一项。 - 生成的音频
file_type为"audio"。 - 时间戳和对齐文件可能使用
file_type: "other"。如有可选的文件元数据，请一并保留。
示例
每个示例都包含请求、对应的已完成任务响应和生成的音频。将请求提交到POST https://api.vidgo.ai/api/generate/submit，然后使用提交返回的任务 ID 查询 GET https://api.vidgo.ai/api/generate/status/{task_id}。
一次折一折
一次折一折
{
"model": "elevenlabs/tts/turbo-v2.5",
"input": {
"similarity_boost": 0.75,
"style": 0,
"apply_text_normalization": "auto",
"text": "Almost there. Fold the top corner down until it meets the center crease. Now press along the edge with your fingertip. That's it. Turn the paper over, and we'll make the next fold together.",
"voice": "Rachel",
"language_code": "en",
"speed": 1.05,
"stability": 0.5,
"timestamps": false
}
}
{
"code": 200,
"data": {
"task_id": "QKTPQMIP4AZY1LGE",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/01/output.mp3",
"file_type": "audio"
}
],
"created_time": "2026-09-27T10:51:18",
"error_message": null,
"progress": 100
}
}
在夜空中寻找北方
在夜空中寻找北方
{
"model": "elevenlabs/tts/turbo-v2.5",
"input": {
"similarity_boost": 0.75,
"style": 0,
"apply_text_normalization": "auto",
"text": "今晚，我们先找到北斗七星，再从勺口两颗星的方向寻找北极星。它看起来并不耀眼，却能帮我们辨认北方。在黑暗中安静地等待片刻，你会发现，夜空远比第一眼看到的更丰富。",
"voice": "Aria",
"language_code": "zh",
"speed": 0.95,
"stability": 0.6,
"timestamps": true
}
}
{
"code": 200,
"data": {
"task_id": "2OAYYBTX2HQT9R8P",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/02/output.mp3",
"file_type": "audio"
},
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/02/attachment-1.json",
"file_type": "other"
}
],
"created_time": "2026-09-27T10:54:18",
"error_message": null,
"progress": 100
}
}
两杯茶
两杯茶
{
"model": "elevenlabs/tts/turbo-v2.5",
"input": {
"similarity_boost": 0.75,
"style": 0,
"apply_text_normalization": "auto",
"text": "Hoy volví a la casa de mi abuela. En la cocina seguía el reloj de siempre, cinco minutos adelantado. Preparé dos tazas de té por costumbre y, al darme cuenta, sonreí. Algunos gestos también guardan recuerdos.",
"voice": "Sarah",
"language_code": "es",
"speed": 0.98,
"stability": 0.45,
"timestamps": false,
"previous_text": "Hacía años que no cruzaba aquella puerta.",
"next_text": "Después abrí las ventanas para dejar entrar la luz."
}
}
{
"code": 200,
"data": {
"task_id": "KAQOQIL83QO5TWA6",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/turbo-v2.5/v1/03/output.mp3",
"file_type": "audio"
}
],
"created_time": "2026-09-27T10:52:07",
"error_message": null,
"progress": 100
}
}
授权
使用 VIDGO_API_KEY。
请求体
application/json