前言

F5-TTS 同步语音合成接口提供实时的语音克隆与合成能力。提交合成请求后，接口会等待任务完成并直接返回合成后的音频文件 URL，可直接播放。

API文档插图

特点：

  • 实时返回，无需轮询
  • 适合短文本（≤1000字符）
  • 音频自动下载到本站服务器，永久有效
  • 支持参考音频音色克隆

接口地址： POST https://www.yuntts.com/api/v1/f5-tts-sync

请求 Headers

Header 值 必填 说明
Authorization Bearer {api_key} 是 API 密钥，格式为 Bearer + 密钥
Content-Type application/json 是 请求体格式

请求 Body

参数 类型 必填 默认值 说明
gen_text string 是 - 要合成的文本，汉字按2倍计费，同步模式≤1000字符
ref_audio_url string 是 - 参考音频 URL（用于音色克隆），必须是可公开访问的音频文件
ref_text string 否 - 参考音频对应的文本内容（可选，提供可提升克隆效果）
model_type string 否 F5-TTS 模型类型，当前仅支持 F5-TTS

请求示例

curl --location --request POST 'https://www.yuntts.com/api/v1/f5-tts-sync' 
--header 'Authorization: Bearer sk-your-api-key' 
--header 'Content-Type: application/json' 
--data-raw '{
    "gen_text": "你好，欢迎使用语音合成服务，这是一段测试语音。",
    "ref_audio_url": "https://example.com/ref-speaker.wav",
    "ref_text": "这是参考音频说的内容"
}'

响应

成功响应（200）

{
    "code": 200,
    "message": "语音合成成功",
    "data": {
        "task_id": "f5tts_sync_abc123def456",
        "char_count": 26,
        "cost": 0.01,
        "status": "completed",
        "audio_url": "https://www.yuntts.com/wp-content/uploads/audio/processed/f5tts_sync_xxx.wav",
        "file_size": 597644,
        "content_type": "audio/wav",
        "message": "语音合成成功"
    }
}
字段 类型 说明
task_id string 本地任务ID
char_count int 计费字符数（汉字×2计算）
cost float 实际扣费金额（元），最低0.001元
status string 任务状态，固定为 completed
audio_url string 音频文件 URL（存储在本站服务器）
file_size int 音频文件大小（字节）
content_type string 音频 MIME 类型
message string 结果消息

错误响应

{
    "code": 400,
    "error": "empty_text",
    "message": "请输入要合成的文字"
}
错误代码 HTTP 状态码 说明
method_not_allowed 405 仅支持 POST 请求
empty_text 400 合成文本为空
missing_ref_audio 400 参考音频 URL 为空
invalid_url 400 参考音频 URL 格式无效
invalid_model 400 不支持的模型类型
text_too_long 400 文本超长（同步模式≤1000字符）
insufficient_balance 402 余额不足
api_error 500 API 调用失败

计费说明

  • 价格： ¥400/百万字符
  • 计费方式： 汉字按2倍计数，其他字符按1倍计数
  • 最低收费： 0.001 元
  • 免费额度：
    • BossVIP 用户：享有永久免费字符额度（后台配置）
    • VIP 用户：享有月度免费字符额度（后台配置）
    • 超出免费额度部分：BossVIP 8折、VIP 9折
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。