音频类免费免Key JSON

通用文本配音

将指定的文本按照选择的角色和风格进行语音合成，并返回生成的音频文件链接

接口地址 https://api.ruseo.cn/api/freedub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/freedub

请求方式GET,POST

返回格式JSON

调用权限免费

ApiKey不需要

创建时间2026-05-26

脚本路由freedub

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

💡 统计个人调用次数

免费API不强制要求API Key，但如果您希望统计个人调用次数，请在请求时附加参数 key=您的API_KEY。注册账号后即可获得API Key。

参数名	必填	类型	说明	示例值
`key`	否	string	可选参数：携带此参数可统计您的个人调用次数。请注册账号获取API Key。	`YOUR_API_KEY`
`text`	是	string	待转换的文本内容	`我是皮尔诺还是熊二呀？`
`role`	否	string	角色名称，可通过GET请求获取列表	`zh-CN-XiaoyiNeural`
`style`	否	string	风格名称，默认为cheerful	`cheerful`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求

https://api.ruseo.cn/api/freedub?text=%E6%88%91%E6%98%AF%E7%9A%AE%E5%B0%94%E8%AF%BA%E8%BF%98%E6%98%AF%E7%86%8A%E4%BA%8C%E5%91%80%EF%BC%9F&role=zh-CN-XiaoyiNeural&style=cheerful

cURL

curl "https://api.ruseo.cn/api/freedub?text=%E6%88%91%E6%98%AF%E7%9A%AE%E5%B0%94%E8%AF%BA%E8%BF%98%E6%98%AF%E7%86%8A%E4%BA%8C%E5%91%80%EF%BC%9F&role=zh-CN-XiaoyiNeural&style=cheerful"

PHP

$url = 'https://api.ruseo.cn/api/freedub?text=%E6%88%91%E6%98%AF%E7%9A%AE%E5%B0%94%E8%AF%BA%E8%BF%98%E6%98%AF%E7%86%8A%E4%BA%8C%E5%91%80%EF%BC%9F&role=zh-CN-XiaoyiNeural&style=cheerful';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/freedub?text=%E6%88%91%E6%98%AF%E7%9A%AE%E5%B0%94%E8%AF%BA%E8%BF%98%E6%98%AF%E7%86%8A%E4%BA%8C%E5%91%80%EF%BC%9F&role=zh-CN-XiaoyiNeural&style=cheerful')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "freedub",
        "example": true
    }
}

返回参数说明

参数名	类型	说明	示例值
`code`	integer	状态码	`200`
`msg`	string	状态信息	`语音合成成功`
`data`	object	返回内容主体
`data.text`	string	请求时传入的文本	`我是皮尔诺还是熊二呀？`
`data.role`	string	请求时使用的角色	`zh-CN-XiaoyiNeural`
`data.style`	string	请求时使用的风格	`cheerful`
`data.audio_url`	string	生成的音频文件链接	`https://api.pearapi.ai/cache/audio/...`

调试参数

请求方式接口地址 key (可选，用于统计个人调用) text * role style

响应结果

◔ --

点击左侧“发送请求”查看结果...