前言F5-TTS 同步语音合成接口提供实时的语音克隆与合成能力。提交合成请求后接口会等待任务完成并直接返回合成后的音频文件 URL已下载到本站服务器可直接播放。特点实时返回无需轮询适合短文本≤1000字符音频自动下载到本站服务器永久有效支持参考音频音色克隆接口地址POST https://www.yuntts.com/api/v1/f5-tts-sync请求 HeadersHeader值必填说明AuthorizationBearer {api_key}是API 密钥格式为Bearer 密钥Content-Typeapplication/json是请求体格式请求 Body参数类型必填默认值说明gen_textstring是-要合成的文本汉字按2倍计费同步模式≤1000字符ref_audio_urlstring是-参考音频 URL用于音色克隆必须是可公开访问的音频文件ref_textstring否-参考音频对应的文本内容可选提供可提升克隆效果model_typestring否F5-TTS模型类型当前仅支持F5-TTS请求示例curl--location--requestPOSThttps://www.yuntts.com/api/v1/f5-tts-sync\--headerAuthorization: Bearer sk-your-api-key\--headerContent-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_idstring本地任务IDchar_countint计费字符数汉字×2计算costfloat实际扣费金额元最低0.001元statusstring任务状态固定为completedaudio_urlstring音频文件 URL存储在本站服务器file_sizeint音频文件大小字节content_typestring音频 MIME 类型messagestring结果消息错误响应{code:400,error:empty_text,message:请输入要合成的文字}错误代码HTTP 状态码说明method_not_allowed405仅支持 POST 请求empty_text400合成文本为空missing_ref_audio400参考音频 URL 为空invalid_url400参考音频 URL 格式无效invalid_model400不支持的模型类型text_too_long400文本超长同步模式≤1000字符insufficient_balance402余额不足api_error500API 调用失败