ModelFold Docs

简体中文

English

简体中文

English

Appearance

ElevenLabs文生语音 多语言V2 ​

本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。

接口 ​

POST /jobs/createTask

完整 URL: https://ai.modelfold.online/v1/jobs/createTask

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

查询任务状态 ​

提交任务后，使用统一的查询端点检查进度并获取结果：

TIP

对于生产环境，我们建议使用 callBackUrl 参数接收自动通知，而不是轮询状态端点。

相关资源 ​

请求参数 ​

请求体 (application/json) ​

参数类型必填说明
modelstring是用于生成的模型名称。必填字段。
- 此端点必须使用 elevenlabs/text-to-speech-multilingual-v2 默认值："elevenlabs/text-to-speech-multilingual-v2"。 可选值：elevenlabs/text-to-speech-multilingual-v2。 示例：elevenlabs/text-to-speech-multilingual-v2。
callBackUrlstring否接收生成任务完成更新的 URL。可选但建议在生产环境中使用。
- 当生成完成时，系统将向此 URL POST 任务状态和结果
- 回调包含生成的 URL 和任务信息
- 您的回调端点应接受包含结果的 JSON 负载的 POST 请求
- 或者，使用获取任务详情端点轮询任务状态
- 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法 示例：https://your-domain.com/api/callback。
inputobject是生成任务的输入参数
  input.textstring是要转换为语音的文本（最大长度：5000 个字符） 示例：Unlock powerful API with ai.modelfold.online! Affordable, scalable APl integration, free trial playground, and secure, reliable performance.。
  input.voicestring是填下表中的音色 ID。可在浏览器中打开 https://static.aiquickdraw.com/elevenlabs/voice/<voice_id>.mp3 试听（将 <voice_id> 替换为实际语音 ID）。例如：https://static.aiquickdraw.com/elevenlabs/voice/EkK5I93UQWFDigLMpZcX.mp3
可用语音列表：
EkK5I93UQWFDigLMpZcX - James - 沙哑、引人入胜、大胆
Z3R5wn05IrDiVCyEkUrK - Arabella - 神秘、富有情感
NNl6r8mD7vthiJatiJt1 - Bradford - 富有表现力、口齿清晰
YOq2y2Up4RgXP2HyXjE5 - Xavier - 霸气、金属感播音员
B8gJV1IhpuegLxdpXFOE - Kuon - 开朗、清晰、稳定
2zRM7PkgwBPiau2jvVXc - Monika Sogam - 低沉、自然
1SM7GgM6IMuvQlz2BwM3 - Mark - 随意、放松、轻快
5l5f8iK3YPeGga21rQIX - Adeline - 女性化、对话式
scOwDtmlUjD3prqpp97I - Sam - 客服代理
NOpBlnGInO9m6vDvFkFC - Spuds Oxley - 睿智、平易近人
BZgkqPqms7Kj9ulSkVzn - Eve - 真实、充满活力、快乐
wo6udizrrtpIxWGp2qJk - Northern Terry
gU0LNdkMOQCOrPrwtbee - British Football Announcer - 英国足球解说员
DGzg6RaUqxGRTHSBjfgF - Brock - 威严、大声的军士
x70vRnQBMBu4FAYhjJbO - Nathan - 虚拟电台主持人
Sm1seazb4gs7RSlUVw7c - Anika - 活泼、友好、引人入胜
P1bg08DkjqiVEzOn76yG - Viraj - 丰富、柔和
qDuRKMlYmrm8trt5QyBn - Taksh - 平静、严肃、流畅
qXpMhyvQqiRxWQs4qSSB - Horatius - 充满活力的角色配音
TX3LPaxmHKxFdv7VOQHJ - Liam - 充满活力、社交媒体创作者
N2lVS1w4EtoT3dr4eOWO - Callum - 沙哑的骗子
FGY2WhTYpPnrIDTdsKH5 - Laura - 热情、古怪的态度
kPzsL2i3teMYv0FxEYQ6 - Brittney - 社交媒体语音 - 有趣、年轻、信息丰富
UgBBYS2sOqTuMpoF3BR0 - Mark - 自然对话
hpp4J3VqNfWAUOO0d1Us - Bella - 专业、明亮、温暖
nPczCjzI2devNBz1zQrb - Brian - 低沉、共鸣、令人安慰
uYXf8XasLslADfZ2MB4u - Hope - 活泼、八卦、少女感
gs0tAILXbY5DNrJrsM6F - Jeff - 优雅、共鸣、强劲
DTKMou8ccj1ZaWGBiotd - Jamahal - 年轻、充满活力、自然
vBKc2FfBKJfcZNyEt1n6 - Finn - 年轻、热切、充满活力
DYkrAHD8iwork3YSUBbs - Tom - 对话与书籍
56AoDkrOh6qfVPDXZ7Pt - Cassidy - 清脆、直接、清晰
eR40ATw9ArzDf9h3v7t7 - Addison 2.0 - 澳大利亚有声书与播客
g6xIsTj2HwM6VR4iXFCw - Jessica Anne Bogart - 健谈、友好
lcMyyd2HUfFzxdCaC4Ta - Lucy - 清新、随意
6aDn1KB0hjpdcocrUkmq - Tiffany - 自然、热情
Sq93GQT4X1lKDXsQcixO - Felix - 温暖、积极、现代RP
flHkNRp1BlvT73UL6gyz - Jessica Anne Bogart - 雄辩的反派
9yzdeviXkFddZ4Oz8Mok - Lutz - 咯咯笑、欢快
pPdl9cQBQq4p6mRkZy2Z - Emma - 可爱、积极向上
zYcjlYFOd3taleS0gkk3 - Edward - 大声、自信、自负
nzeAacJi50IvxcyDnMXa - Marshal - 友好、幽默的教授
ruirxsoakN0GWmGNIo04 - John Morgan - 粗犷、坚韧的牛仔
TC0Zp7WVFzhA8zpTlRqV - Aria - 性感反派
ljo9gAlSqKOvF6D8sOsX - Viking Bjorn - 史诗中世纪掠夺者
PPzYpIqttlTYA83688JI - Pirate Marshal - 海盗元帅
8JVbfL6oEdmuxKn5DK2C - Johnny Kid - 严肃、平静的旁白
iCrDUkL56s3C8sCRl7wb - Hope - 诗意、浪漫、迷人
wJqPPQ618aTW29mptyoc - Ana Rita - 流畅、富有表现力、明亮
EiNlNiXeDU1pqqOPrYMO - John Doe - 低沉
4YYIPFl9wE5c4L2eu2Gb - Burt Reynolds™ - 低沉、流畅、清晰
6F5Zhi321D3Oq7v1oNT4 - Hank - 低沉、引人入胜的旁白
YXpFCvM1S3JbWEJhoskW - Wyatt - 睿智乡村牛仔
LG95yZDEHg6fCZdQjLqj - Phil - 爆发力、热情播音员
CeNX9CMwmxDxUF5Q2Inm - Johnny Dynamite - 复古电台DJ
aD6riP1btT197c6dACmy - Rachel M - 专业英国电台主持人
mtrellq69YZsNwzUSyXh - Rex Thunder - 低沉强硬
dHd5gvgSOzSfduK4CvEg - Ed - 深夜播音员
eVItLK1UvXctxuaRV2Oq - Jean - 迷人、俏皮的蛇蝎美人
esy0r39YPLQjOczyOib8 - Britney - 冷静、算计的反派
Tsns2HvNFKfGiNjllgqo - Sven - 情感丰富、友善
1U02n4nD6AdIZ9CjF053 - Viraj - 流畅、温柔
AeRdCCKzvd23BpJoofzx - Nathaniel - 引人入胜、英式、平静
LruHrtVF6PSyGItzMNHS - Benjamin - 低沉、温暖、平静
1wGbFxmAM3Fgw63G1zZJ - Allison - 平静、舒缓、冥想
hqfrgApggtO1785R4Fsn - Theodore HQ - 宁静、沉稳
MJ0RnG71ty4LH3dvNfSd - Leon - 舒缓、沉稳 默认值："EkK5I93UQWFDigLMpZcX"。 可选值：EkK5I93UQWFDigLMpZcX / Z3R5wn05IrDiVCyEkUrK / NNl6r8mD7vthiJatiJt1 / YOq2y2Up4RgXP2HyXjE5 / B8gJV1IhpuegLxdpXFOE / 2zRM7PkgwBPiau2jvVXc / 1SM7GgM6IMuvQlz2BwM3 / 5l5f8iK3YPeGga21rQIX / scOwDtmlUjD3prqpp97I / NOpBlnGInO9m6vDvFkFC / BZgkqPqms7Kj9ulSkVzn / wo6udizrrtpIxWGp2qJk / gU0LNdkMOQCOrPrwtbee / DGzg6RaUqxGRTHSBjfgF / x70vRnQBMBu4FAYhjJbO / Sm1seazb4gs7RSlUVw7c / P1bg08DkjqiVEzOn76yG / qDuRKMlYmrm8trt5QyBn / qXpMhyvQqiRxWQs4qSSB / TX3LPaxmHKxFdv7VOQHJ / N2lVS1w4EtoT3dr4eOWO / FGY2WhTYpPnrIDTdsKH5 / kPzsL2i3teMYv0FxEYQ6 / UgBBYS2sOqTuMpoF3BR0 / hpp4J3VqNfWAUOO0d1Us / nPczCjzI2devNBz1zQrb / uYXf8XasLslADfZ2MB4u / gs0tAILXbY5DNrJrsM6F / DTKMou8ccj1ZaWGBiotd / vBKc2FfBKJfcZNyEt1n6 / DYkrAHD8iwork3YSUBbs / 56AoDkrOh6qfVPDXZ7Pt / eR40ATw9ArzDf9h3v7t7 / g6xIsTj2HwM6VR4iXFCw / lcMyyd2HUfFzxdCaC4Ta / 6aDn1KB0hjpdcocrUkmq / Sq93GQT4X1lKDXsQcixO / flHkNRp1BlvT73UL6gyz / 9yzdeviXkFddZ4Oz8Mok / pPdl9cQBQq4p6mRkZy2Z / zYcjlYFOd3taleS0gkk3 / nzeAacJi50IvxcyDnMXa / ruirxsoakN0GWmGNIo04 / TC0Zp7WVFzhA8zpTlRqV / ljo9gAlSqKOvF6D8sOsX / PPzYpIqttlTYA83688JI / 8JVbfL6oEdmuxKn5DK2C / iCrDUkL56s3C8sCRl7wb / wJqPPQ618aTW29mptyoc / EiNlNiXeDU1pqqOPrYMO / 4YYIPFl9wE5c4L2eu2Gb / 6F5Zhi321D3Oq7v1oNT4 / YXpFCvM1S3JbWEJhoskW / LG95yZDEHg6fCZdQjLqj / CeNX9CMwmxDxUF5Q2Inm / aD6riP1btT197c6dACmy / mtrellq69YZsNwzUSyXh / dHd5gvgSOzSfduK4CvEg / eVItLK1UvXctxuaRV2Oq / esy0r39YPLQjOczyOib8 / Tsns2HvNFKfGiNjllgqo / 1U02n4nD6AdIZ9CjF053 / AeRdCCKzvd23BpJoofzx / LruHrtVF6PSyGItzMNHS / 1wGbFxmAM3Fgw63G1zZJ / hqfrgApggtO1785R4Fsn / MJ0RnG71ty4LH3dvNfSd。 示例：EkK5I93UQWFDigLMpZcX。
  input.stabilitynumber否语音稳定性（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认值：0.5。 示例：0.5。
  input.similarity_boostnumber否相似度提升（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认值：0.75。 示例：0.75。
  input.stylenumber否风格夸张程度（0-1）（最小值：0，最大值：1，步长：0.01）（步长：0.01） 默认值：0。 示例：0。
  input.speednumber否语音速度（0.7-1.2）。低于 1.0 的值会减慢语音，高于 1.0 的值会加速语音。极端值可能会影响质量。（最小值：0.7，最大值：1.2，步长：0.01）（步长：0.01） 默认值：1。 示例：1。
  input.timestampsboolean否是否返回生成语音中每个单词的时间戳（布尔值：true/false） 示例：false。
  input.previous_textstring否当前请求文本之前出现的文本。可以用来在连接多个生成时改善语音连续性，或者影响当前生成中的语音连续性。（最大长度：5000 个字符） 示例：``。
  input.next_textstring否当前请求文本之后出现的文本。可以用来在连接多个生成时改善语音连续性，或者影响当前生成中的语音连续性。（最大长度：5000 个字符） 示例：``。
  input.language_codestring否语言代码（ISO 639-1），用于为模型强制指定语言。目前只有 Turbo v2.5 和 Flash v2.5 支持语言强制。对于其他模型，如果提供了语言代码，将返回错误。（最大长度：500 个字符） 示例：``。

请求示例 ​

bash
curl -X POST "https://ai.modelfold.online/v1/jobs/createTask" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs/text-to-speech-multilingual-v2",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "text": "Unlock powerful API with ai.modelfold.online! Affordable, scalable APl integration, free trial playground, and secure, reliable performance.",
    "voice": "EkK5I93UQWFDigLMpZcX",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": false,
    "previous_text": "",
    "next_text": "",
    "language_code": ""
  }
}'
json
{
  "model": "elevenlabs/text-to-speech-multilingual-v2",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "text": "Unlock powerful API with ai.modelfold.online! Affordable, scalable APl integration, free trial playground, and secure, reliable performance.",
    "voice": "EkK5I93UQWFDigLMpZcX",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": false,
    "previous_text": "",
    "next_text": "",
    "language_code": ""
  }
}

响应 ​

200 — 请求成功 ​

参数类型必填说明
codeinteger是请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。 可选值：200 / 401 / 402 / 404 / 422 / 429 / 433 / 455 / 500 / 501 / 505。 示例：200。
msgstring是响应消息，失败时的错误描述
dataobject是—
  data.taskIdstring是可以使用任务 ID 与“获取任务详细信息”端点一起查询任务状态。
json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "281e5b0*********************f39b9"
  }
}

回调 ​

musicTaskCompleted ​

回调地址：{request.body#/callBackUrl}（即请求体里的 callBackUrl）。

音频任务成功或失败时，系统会向该地址发送回调。

回调体参数

参数类型必填说明
codeinteger是统一回调状态码：成功为 200，失败为 501。 可选值：200 / 501。 示例：200。
msgstring是统一回调消息。 可选值：Playground task completed successfully. / Playground task failed.。 示例：Playground task completed successfully.。
dataobject是—
  data.taskIdstring是任务唯一标识符。
  data.modelstring是任务使用的模型。 可选值：elevenlabs/text-to-speech-multilingual-v2。 示例：elevenlabs/text-to-speech-multilingual-v2。
  data.statestring是任务最终状态。 可选值：success / fail。 示例：success。
  data.paramstring是包含已提交任务参数的 JSON 字符串。
  data.resultJsonstring否任务成功时，包含 resultUrls 和 resultObject 的 JSON 字符串；任务。仅在 state 为 success 时出现。
  data.failCodestring否失败码，数字字符串，如 "400"、"500"。仅在 state 为 fail 时出现。
  data.failMsgstring否失败原因，仅在 state 为 fail 时出现。
  data.costTimeinteger否处理耗时（秒），成功和失败回调都会返回。
  data.completeTimeinteger否任务完成时间戳。
  data.createTimeinteger否任务创建时间戳。
  data.updateTimeinteger否完成时间请以 completeTime 为准；updateTime 可能与 createTime 相同。
  data.creditsConsumednumber否本任务消耗的积分；失败任务为 0。

任务成功完成

json
{
  "code": 200,
  "msg": "Playground task completed successfully.",
  "data": {
    "taskId": "task_example_music_webhook_001",
    "model": "elevenlabs/text-to-speech-multilingual-v2",
    "state": "success",
    "param": "{\"input\":\"{\\\"text\\\":\\\"Unlock powerful API with ai.modelfold.online! Affordable, scalable APl integration, free trial playground, and secure, reliable pe...\\\",\\\"voice\\\":\\\"Rachel\\\",\\\"stability\\\":0.5,\\\"similarity_boost\\\":0.75,\\\"style\\\":0,\\\"speed\\\":1,\\\"timestamps\\\":false,\\\"previous_text\\\":\\\"\\\",\\\"next_text\\\":\\\"\\\",\\\"language_code\\\":\\\"\\\"}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"elevenlabs/text-to-speech-multilingual-v2\"}",
    "resultJson": "{\"resultUrls\":[\"https://example.com/generated-audio.mp3\"],\"resultObject\":null}",
    "costTime": 12,
    "completeTime": 1234567890,
    "createTime": 1234560000,
    "updateTime": 1234567890,
    "creditsConsumed": 1.23
  }
}

任务失败

json
{
  "code": 501,
  "msg": "Playground task failed.",
  "data": {
    "taskId": "task_example_music_webhook_001",
    "model": "elevenlabs/text-to-speech-multilingual-v2",
    "state": "fail",
    "param": "{\"input\":\"{\\\"text\\\":\\\"Unlock powerful API with ai.modelfold.online! Affordable, scalable APl integration, free trial playground, and secure, reliable pe...\\\",\\\"voice\\\":\\\"Rachel\\\",\\\"stability\\\":0.5,\\\"similarity_boost\\\":0.75,\\\"style\\\":0,\\\"speed\\\":1,\\\"timestamps\\\":false,\\\"previous_text\\\":\\\"\\\",\\\"next_text\\\":\\\"\\\",\\\"language_code\\\":\\\"\\\"}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"elevenlabs/text-to-speech-multilingual-v2\"}",
    "failCode": "400",
    "failMsg": "<error detail>",
    "costTime": 12,
    "creditsConsumed": 0
  }
}

ModelFold — 一个 API，接入所有主流 AI 模型。

© 2026 ModelFold