> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 混合音频 (Mux Audio)

> 为片段附加音轨——可替换原声，也可叠加在原声之上。

<Frame caption="混合音频 (Mux Audio) · 截图待补">
  <img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=b54171099e5b02d4313fe581171ebbcc" alt="混合音频 (Mux Audio)" width="800" height="450" data-path="images/nodes/_placeholder.svg" />
</Frame>

## 这个节点是做什么的

**Mux Audio** 把一段视频与一个独立音频源合并成一个片段。它接收一个 `COMFYTV_VIDEO` 和一个 `COMFYTV_AUDIO`，
点 **▶ 运行**后用 PyAV / ffmpeg 将二者混流成一个新的 MP4，保存为项目快照。它**同时需要**上游视频和上游音频，
否则运行会报错。输出为 `COMFYTV_VIDEO`。

## 适用场景

* 给一个无声（或将被替换声音）的片段铺上背景音乐或旁白。
* 把片段原声换成清理后的或配音的音轨。
* 把生成的语音/音效叠加到已有素材的原声之上。

## 参数说明

### mode（模式）

传入音频与片段原有音频如何相遇：

* **replace（替换，默认）**——丢弃片段原声，只用传入的音轨。
* **mix（混合）**——把传入音轨与片段原声混合在一起。

### offset\_s（时间偏移）

把传入音频在时间上平移，单位秒。范围 **−600 到 600**，步进 0.05，默认 **0.0**。正值延后音频（更晚开始）；
负值提前。用它把旁白或音乐与画面对齐。

## 输入与输出

| 端口           | 类型              | 含义                    |
| ------------ | --------------- | --------------------- |
| **video**（入） | `COMFYTV_VIDEO` | 保留其画面的片段。             |
| **audio**（入） | `COMFYTV_AUDIO` | 要附加的音轨。               |
| **video**（出） | `COMFYTV_VIDEO` | 换上新音频/混合音频后的片段，保存为快照。 |

## 小贴士

* 两个输入都必填——缺视频或缺音频都会报错。
* 原声不想要时用 **replace**；想两者都保留（如环境声加背景音乐）时用 **mix**。
* 小步微调 **offset\_s**，让语音与口型对上。

## Bridge 说明

`COMFYTV_VIDEO` 与 `COMFYTV_AUDIO` 都是项目快照引用，不是 ComfyUI 原生张量。要在 ComfyTV 与原生 ComfyUI
节点之间互通，请插入 **Bridge**（`ComfyTV/Bridge`）。详见
[https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md。](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md。)

## 相关节点

* **Video Volume**——混合前先设好片段自身的音量。
* **Video Concat**——先拼好序列，再对整段混入一条统一配乐。