跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
elevenlabs-tts-turbo-2-5 将文本输入转换为低延迟的多语言语音音频。结果以任务 files 返回,与图像、视频、3D 和音频任务的标准响应结构一致。

模型

  • elevenlabs-tts-turbo-2-5 - ElevenLabs TTS Turbo v2.5 文本转语音生成

必填参数

  • text:要转换为语音的文本
    • 长度:1-40000 个字符
    • 将长篇旁白拆分为多个请求时,使用 previous_text 和 next_text

可选参数

  • 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 时,生成的音频可能附带时间戳数据
  • previous_text:可选,位于 text 之前的上下文,有助于保持长篇内容连贯
  • next_text:可选,位于 text 之后的上下文,有助于保持长篇内容连贯
  • language_code:可选的 ISO 639-1 代码,用于强制指定目标语言,例如 en、fr、de、ja、vi、hu 或 no
  • apply_text_normalization:auto、on 或 off。默认:auto

示例

低延迟产品配音

本地化取货通知

长篇内容连贯

富有表现力的主持人开场

注意事项

  • PoYo 对外公开的参数名是 text。
  • 通过标准任务状态 API 查询状态。
  • 成功响应返回 files,其中生成的语音使用 file_type: audio。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
必填

模型标识符。

可用选项:
elevenlabs-tts-turbo-2-5
示例:

"elevenlabs-tts-turbo-2-5"

input
object
必填
callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

响应

任务提交成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填