vLLM Omni 提示：boundary_ratio 缺失，自动使用默认 0.875

一、日志含义

plaintext

boundary_ratio is required for T2V generation. using default value 0.875

• T2V = Text to Video 文生视频
• boundary_ratio 是文生视频分段边界切分比例参数，启动时没有手动指定该参数，vLLM Omni 自动兜底采用内置默认值 0.875。
• 这条只是警告信息，不是报错，推理可以正常跑，不会直接崩溃。

二、参数作用

boundary_ratio 用于长视频生成时，切分上下文窗口、帧序列分段拼接的边界权重：

• 取值范围一般 0~1，官方默认固定 0.875
• 数值越大：前后片段重叠越多，视频画面连贯性更强，但显存占用略高
• 数值越小：分段更干脆，显存压力更小，容易出现画面跳变、断帧

三、两种解决方式

方式 1：启动命令行显式指定（推荐，消除警告）

在你启动 vllm serve /vllm run 的启动参数里追加：

bash

运行

--boundary_ratio 0.875

示例完整启动片段：

bash

运行

vllm serve 你的模型路径 \
  --task t2v \
  --boundary_ratio 0.875 \
  --tensor-parallel-size 2

方式 2：代码内传入参数（Python API 调用）

python

运行

from vllm import LLM

llm = LLM(
    model="你的T2V模型",
    task="t2v",
    boundary_ratio=0.875,
    tensor_parallel_size=2
)

四、是否需要修改默认值？

1. 日常正常生成：直接沿用 0.875 即可，无需改动
2. 超长视频容易 OOM：调低至 0.7 / 0.75
3. 画面衔接卡顿、前后帧割裂：调高至 0.9

五、如果依旧报错

若后续从警告变成强制报错 must specify boundary_ratio，说明该版本 vLLM-Omni 做了强校验，必须手动传入该参数，不能依赖自动默认，务必在启动参数强制加上 --boundary_ratio 0.875。