云凡智联

首页/开放能力

digitalHuman

数字人口播

通过 RunningHub 驱动数字人视频口型，支持使用另一段视频的音轨或直接上传纯音频。

20积分/分钟

基础说明

通过 RunningHub 驱动数字人视频口型，支持使用另一段视频的音轨或直接上传纯音频。

提交任务

提交 RunningHub 数字人口播任务。主视频提供数字人画面，音频可来自另一段视频或纯音频文件。

POST/api/third-party/digitalHuman/generate

请求头

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

请求参数

字段	类型	必填	说明
video	string	是	数字人主视频的公网 HTTP/HTTPS URL，或 RunningHub 已上传素材的 fileName。
duration	number	否	视频读取时长，范围 1-600 秒，默认 10 秒。
audioSource	number	否	音频来源：0 使用 audioVideo 的音轨；1 使用 audio，默认 1。
audioVideo	string	条件必填	用于提取音频的视频 URL 或 RunningHub fileName；audioSource=0 时必填。
audio	string	条件必填	纯音频 URL 或 RunningHub fileName；audioSource=1 时必填，支持 RunningHub 可识别的音频格式。

请求示例

bash

curl -X POST "https://yunfanzhilian.com/api/third-party/digitalHuman/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://your-cdn.com/digital-human.mp4",
    "duration": 10,
    "audioSource": 1,
    "audio": "https://your-cdn.com/speech.flac"
  }'

响应字段

字段	类型	必填	说明
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",
    "duration": 10,
    "audioSource": 1,
    "chargedMinutes": 1,
    "costPerMinute": 20,
    "cost": 20,
    "recordId": "67f000000000000000000001"
  },
  "timestamp": "2026-09-02T13:30:00.000Z"
}

注意事项

公网素材会先由服务端上传到 RunningHub；也可以直接传 RunningHub 上传接口返回的 fileName。
audioSource=0 时仅提交 audioVideo（节点 68）；audioSource=1 时仅提交 audio（节点 79），未选中的音频节点不会传给 RunningHub。
上游使用固定 AI App 1979966169551638530，并按对应节点映射提交。
按 duration 向上取整到分钟预扣积分，每分钟 20 积分；上游提交失败或任务失败时自动退回。
提交后可通过统一获取结果接口轮询，建议间隔 20-30 秒。