云凡智联

首页/开放能力

audioClone

音频刻录

上传一段参考音频并输入朗读文案，通过 RunningHub 复刻参考音色并生成新音频。

0.5积分/秒

基础说明

上传一段参考音频并输入朗读文案，通过 RunningHub 复刻参考音色并生成新音频。

提交任务

上传参考音频和朗读文案，提交 RunningHub 音色复刻任务。

POST/api/third-party/audioClone/generate

请求头

字段	类型	必填	说明
X-API-Token	string	是	平台提供的调用凭证，用于识别当前账号或租户。
Content-Type	string	是	提交任务时固定使用 application/json。

请求参数

字段	类型	必填	说明
audio	string	是	参考音频的公网 HTTP/HTTPS URL，或 RunningHub 已上传素材的 fileName。
text	string	是	新音频需要朗读的文案，最多 2000 个字符。

请求示例

bash

curl -X POST "https://yunfanzhilian.com/api/third-party/audioClone/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://your-cdn.com/reference-voice.mp3",
    "text": "欢迎来到云凡智联，这是通过参考音色生成的新音频。"
  }'

响应字段

字段	类型	必填	说明
code	number	-	业务状态码，200 表示请求成功。
message	string	-	本次请求的结果说明。
data.taskId	string	-	任务 ID。提交成功后请保存，用于查询生成结果。
data.cost	number	-	本次提交预扣积分。
data.status	string	-	任务初始状态，通常为 pending 或 processing。
timestamp	string	-	响应时间，ISO 8601 格式。

响应示例

json

{
  "code": 200,
  "message": "音频刻录任务已提交",
  "data": {
    "taskId": "task_xxxxxxxx",
    "status": "processing",
    "estimatedDuration": 6,
    "estimatedBilledSeconds": 6,
    "costPerSecond": 0.5,
    "estimatedCost": 3,
    "cost": 3,
    "recordId": "67f000000000000000000004"
  },
  "timestamp": "2026-09-04T10:00:00.000Z"
}

注意事项

参考音频建议为 3-20 秒、环境安静且只有一人说话的清晰音频。
公网音频会先由服务端上传到 RunningHub；也可以直接传 RunningHub fileName。
上游使用固定 AI App 1981402417570947073，参考音频映射节点 80，文案映射节点 87。
按成品音频实际时长结算，每秒 0.5 积分；提交时按文案预计时长预扣，完成后根据实际时长多退少补。
实际时长按整秒向上取整计费，例如 3 秒成品最终扣除 1.5 积分。
提交失败或任务失败时自动退回本次预扣积分。
提交后可通过统一获取结果接口轮询，建议间隔 5-10 秒。