curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "elevenlabs/tts/eleven-v3",
"input": {
"text": "[whispers] Wait... that ticking is coming from inside the wall. [curious] This little brass key fits the crack. One turn, and... [excited] the whole ceiling is full of stars! [laughs] Grandpa, you built a planetarium in the attic. [exhales] All these years, it was waiting for us.",
"voice": "Charlotte",
"language_code": "en",
"stability": 0.5,
"timestamps": false,
"apply_text_normalization": "auto"
}
}
'{
"code": 200,
"data": {
"task_id": "LPV36KJQ0Y2SYT21",
"status": "running",
"created_time": "2026-09-27T10:45:57"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}ElevenLabs
ElevenLabs V3 TTS
使用 ElevenLabs V3 将文本转为语音，可选择音色、控制语言，并可返回时间戳，适用于旁白和对话。
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 '
{
"model": "elevenlabs/tts/eleven-v3",
"input": {
"text": "[whispers] Wait... that ticking is coming from inside the wall. [curious] This little brass key fits the crack. One turn, and... [excited] the whole ceiling is full of stars! [laughs] Grandpa, you built a planetarium in the attic. [exhales] All these years, it was waiting for us.",
"voice": "Charlotte",
"language_code": "en",
"stability": 0.5,
"timestamps": false,
"apply_text_normalization": "auto"
}
}
'{
"code": 200,
"data": {
"task_id": "LPV36KJQ0Y2SYT21",
"status": "running",
"created_time": "2026-09-27T10:45:57"
}
}{
"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/eleven-v3 - 将文本转换为语音。
功能
- 将文本转换为语音。
- 可在生成音频的同时请求时间戳。
- 使用
voice选择音色，使用language_code指定朗读语言。
高级参数
在请求根级设置model 和可选的 callback_url。所有工作流程参数（包括输出选项）都放在 input 中。
文本
text：必填。要朗读的文本。长度：1-5,000 个字符。- 检查字符上限前会先去除首尾空白。
音色
voice：可选。选择音色。字符串。默认：Rachel。- 可选值：
Aria、Roger、Sarah、Laura、Charlie、George、Callum、River、Liam、Charlotte、Alice、Matilda、Will、Jessica、Eric、Chris、Brian、Daniel、Lily、Bill、Rachel。
稳定性
stability：可选。控制音色稳定性。数值0到1。默认：0.5。
时间戳
timestamps：可选。在返回音频的同时请求时间戳信息。使用true或false。默认：false。
语言代码
language_code：可选。ISO 639-1 语言代码，例如英语为en，中文为zh。
文本规范化
apply_text_normalization：可选。选择文本规范化行为。可选值：auto、on、off。默认：auto。
输出文件
- 读取返回的
files数组中的每一项。 - 生成的音频
file_type为"audio"。 - 返回的
timestamps.json是单独的一项，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/eleven-v3",
"input": {
"text": "[whispers] Wait... that ticking is coming from inside the wall. [curious] This little brass key fits the crack. One turn, and... [excited] the whole ceiling is full of stars! [laughs] Grandpa, you built a planetarium in the attic. [exhales] All these years, it was waiting for us.",
"voice": "Charlotte",
"language_code": "en",
"stability": 0.5,
"timestamps": false,
"apply_text_normalization": "auto"
}
}
{
"code": 200,
"data": {
"task_id": "LPV36KJQ0Y2SYT21",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/eleven-v3/v1/01/speech.mp3",
"file_type": "audio",
"file_name": "speech.mp3"
}
],
"created_time": "2026-09-27T10:45:57",
"error_message": null,
"progress": 100
}
}
我的第一个饺子
我的第一个饺子
{
"model": "elevenlabs/tts/eleven-v3",
"input": {
"text": "[sighs] 我练了一个下午，面团还是歪歪扭扭的。奶奶看了一眼，说：别急，手放轻一点。[curious] 这样吗？先对折，再慢慢捏紧……[laughs] 真的站住了！虽然像只胖企鹅，但这是我第一次包好饺子。原来，有些本事不是听懂的，是一起做着学会的。",
"voice": "Rachel",
"language_code": "zh",
"stability": 0.5,
"timestamps": false,
"apply_text_normalization": "auto"
}
}
{
"code": 200,
"data": {
"task_id": "VLXQ5DI7PNWFRJQ4",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/eleven-v3/v1/02/speech.mp3",
"file_type": "audio",
"file_name": "speech.mp3"
}
],
"created_time": "2026-09-27T10:46:38",
"error_message": null,
"progress": 100
}
}
声音的性格
声音的性格
{
"model": "elevenlabs/tts/eleven-v3",
"input": {
"text": "[curious] Why does a violin sound different from a flute when both play the same note? Their fundamental frequency can match, but the overtones do not. [excited] Those extra vibrations give each instrument its own sound. At 440 Hz, the pitch is A; the pattern above it is what makes the voice of the instrument recognizable.",
"voice": "George",
"language_code": "en",
"stability": 0.5,
"timestamps": true,
"apply_text_normalization": "on"
}
}
{
"code": 200,
"data": {
"task_id": "0E09515629QS87GR",
"status": "finished",
"files": [
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/eleven-v3/v1/03/speech.mp3",
"file_type": "audio",
"file_name": "speech.mp3"
},
{
"file_url": "https://cdn.vidgo.ai/apis/models/elevenlabs/tts/eleven-v3/v1/03/timestamps.json",
"file_type": "other",
"file_name": "timestamps.json"
}
],
"created_time": "2026-09-27T10:47:13",
"error_message": null,
"progress": 100
}
}
授权
使用 VIDGO_API_KEY。
请求体
application/json