curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "elevenlabs-v4-tts",
"input": {
"text": "Hello! Welcome to PoYo."
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-10-13T10:30:00+08:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}ElevenLabs
ElevenLabs V4 TTS
ElevenLabs V4 TTS API 可将最多 5,000 个字符的文本转换为语音，支持音色、稳定性和相似度控制，以及可选的语言代码。可从 19 种音频格式中选择一种，并可选择将时间戳作为单独文件返回。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "elevenlabs-v4-tts",
"input": {
"text": "Hello! Welcome to PoYo."
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-10-13T10:30:00+08:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
elevenlabs-v4-tts 将文本转换为富有表现力的语音音频。结果以任务 files 返回，与图像、视频、3D 和音频任务的标准响应结构一致。
模型
- elevenlabs-v4-tts - ElevenLabs V4 文本转语音生成
必填参数
- text：要转换为语音的文本
- 长度：
1-5000个字符，需包含非空白文本
- 长度：
可选参数
- voice：音色名称或音色 ID。默认：
Rachel - stability：音色稳定性，
0到1。默认：0.5 - similarity_boost：音色相似度，
0到1。默认：0.75 - language_code：可选的 ISO 639-1 语言代码
- apply_text_normalization：
auto、on或off。默认：auto - timestamps：布尔值。为
true时，时间数据可能作为单独的 JSON 文件返回。默认：false - output_format：音频编码、采样率和码率。默认：
mp3_44100_128 - callback_url：可选的 Webhook URL，用于任务完成通知
输出格式
支持的值：mp3_22050_32、mp3_44100_32、mp3_44100_64、mp3_44100_96、mp3_44100_128、mp3_44100_192、pcm_8000、pcm_16000、pcm_22050、pcm_24000、pcm_44100、pcm_48000、ulaw_8000、alaw_8000、opus_48000_32、opus_48000_64、opus_48000_96、opus_48000_128、opus_48000_192。
MP3 和 Opus 是编码音频。PCM 是不带 WAV 头的原始音频。µ-law 和 A-law 是电话通信格式。输出保留原始编码和文件扩展名。解码原始音频时请使用所选的采样率。
示例
默认语音
{
"model": "elevenlabs-v4-tts",
"callback_url": "https://your-domain.com/callback",
"input": {
"text": "Hello! Welcome to PoYo.",
"voice": "Rachel",
"stability": 0.5,
"similarity_boost": 0.75,
"apply_text_normalization": "auto"
}
}
带时间戳的原始 PCM
{
"model": "elevenlabs-v4-tts",
"callback_url": "https://your-domain.com/callback",
"input": {
"text": "Welcome to PoYo.",
"timestamps": true,
"output_format": "pcm_24000"
}
}
注意事项
- 通过标准任务状态 API 查询状态。
- 成功响应返回
files。生成的语音使用file_type: audio。 - 启用
timestamps且返回了时间数据时，时间 JSON 是一个单独的文件项，file_type: other。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务已受理；请查询任务获取最终文件。
Show child attributes
Show child attributes