照片加音频生成会说话的数字人视频

照片加音频生成会说话的数字人视频

一个 n8n 工作流。通过它的表单发一张人像和一段音频录音，它会返回一段在 RunningHub 上做出来的数字人说话视频。

包里有什么

• workflow.json：n8n 导出的工作流，14 个节点。里面没有任何凭据。你的 RunningHub 密钥只填进一个节点，API Setup。
• README.md：这份设置说明，压缩包里的是英文版。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 RunningHub 账号和它的 API 密钥。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 打开 API Setup，把 YOUR_RUNNINGHUB_API 换成你的 RunningHub API 密钥。每个 HTTP Request 节点都从这里读它。
3. 可选：打开 On form submission，修改表单标题或它接受的文件类型。文件里图片接受 .jpg、.png、.jpeg 和 .webp，音频接受 .mp3、.wav 和 .flac。
4. 保存，打开表单的测试地址，用它发送一张人像和一个音频文件。
5. 点 Publish 发布，再分享表单的正式地址。

表单会立刻确认收到。运行在后台继续，成品视频保存在这次运行的执行数据里，到 Executions 里打开这次运行就能拿到。在 downloadVideo 后面加一个节点，可以把视频存到网盘或转发出去。

它怎么运行

1. API Setup 保存密钥，Code in JavaScript 把表单里的两个文件往下传。
2. uploadImage 和 uploadAudio 并行地各给 RunningHub 发一个文件。Merge 和 Aggregate 把两份回复合成一条数据。
3. createTask 在 RunningHub 的一个工作流上创建任务，把图片保存后的名字放进 12 号节点，音频的放进 19 号节点，把裁剪方式 center 放进 14 号节点。
4. Wait 先暂停一分钟，然后 checkStatus 询问任务状态。Switch 把 SUCCESS 交给 getOutput，把 QUEUED 和 RUNNING 经 Wait1（15 秒）送回 checkStatus，FAILED 则不连任何节点。
5. getOutput 取得结果的地址，downloadVideo 下载这个文件。

| 节点 | RunningHub 端点 | 发送 | 返回 |
|---|---|---|---|
| uploadImage、uploadAudio | /task/openapi/upload | 密钥和一个文件 | 保存下来的文件的 fileName |
| createTask | /task/openapi/create | 密钥、workflowId、nodeInfoList | 一个 taskId |
| checkStatus | /task/openapi/status | 密钥和 taskId | FAILED、SUCCESS、QUEUED 或 RUNNING |
| getOutput | /task/openapi/outputs | 密钥和 taskId | 视频的 fileUrl |

修改结果

• 裁剪：createTask 的 nodeInfoList 里的 crop，设成 center。
• 时间：Wait（第一次检查前等一分钟）和 Wait1（两次检查间隔 15 秒）。
• 运行 RunningHub 上的哪个工作流：createTask 里的 workflowId。旁边的节点编号属于那个工作流，所以改指向别的工作流时，要一起改。
• 表单：在 On form submission 里重命名字段，或修改接受的文件类型。

注意事项

• RunningHub 把每个任务记在你的账号上收费。
• Switch 的 0 号输出对应 FAILED，它哪里也不通。没有视频出现时，到 Executions 里看这次运行。
• 没有任何东西限制状态循环：一直排队或运行的任务，会被反复检查，直到它结束。
• 工作流发布之后，任何拿到表单地址的人都能在你的 RunningHub 账号上发起运行。
• 密钥以明文放在 API Setup 里，所以任何能打开这个工作流的人都能看到。
• 人像和录音会上传到 RunningHub。请使用你有权使用的人脸和声音。