前言

F5-TTS 同步语音合成接口提供实时的语音克隆与合成能力。提交合成请求后,接口会等待任务完成并直接返回合成后的音频文件 URL(已下载到本站服务器,可直接播放)。
F5-TTS文字转语音

特点:

  • 实时返回,无需轮询
  • 适合短文本(≤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 调用失败
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐