一、我的痛点，和它能帮我解决什么
痛点三条。一是片头手做要素材加剪辑技能，我两样都缺，这一环在工程里空了很久。二是生成路线的等待和默认值不透明，第一次跑不知道要等多久、掉出来的文件带不带角标。三是假设碎掉的时候没处查，seed 管不管用、轮询为什么报超时，只能自己撞一遍再自己记下来。
对应的解法也是三条。一条命令 148 秒出 5 秒 1080P 片头，素材和剪辑都省了，工程里那一格填上了。等待、默认角标、seed 三个读数这轮都留了实证，下一次跑不用重新猜；单次读数只说明路通路堵，不包稳定，这条我也写在判据里。角标开关（默认带、显式能关）试通了，品牌片头知道该加哪一行、timeout 给多少。
不能解决的：细节不可控，想在画面里精确放一个 logo 就别指望；seed 不复现，重跑留文件；图生视频、首尾帧、file-to-video、Prime 和 720P 档这轮都没测，不下结论。
给手做路线一句公道话：素材可控、能逐帧返工、不用赌那段等待，交付要求卡死每一帧的时候它更稳，这条路线不会因为生成能力出现就该退场。生成路线赢在省素材省技能，输在细节不可控，两条路各占一段。
不适合谁：要精确复现同一版片头的、要逐帧改字改 logo 的、以及没条件多跑几条挑的团队，这轮的路子先别当主力。
二、接一个新能力之前，我先问三件事
演示工程里最容易被跳过的一环是开头那五秒。功能走位、结尾联系方式都排好了，片头位置一直空着，因为手做要素材库加剪辑技能，我这两样都缺。
这轮我打算把这一环换成一条命令：阿里云百炼的文生视频 bl video generate，默认模型 wan3.0-video。第一次跑就拿到了能用的 5 秒片头，同时撞出三个得先摸清的读数。
接进流程之前我要问的也就是这三件：等待有多长、默认值里带了什么、复现能不能指望。这三条没有读数，演示前一天出问题就没法定位，只能整段重做。
三、接口面：先把 flag 认清楚
bl video generate --help 里跟片头这条动线有关的是这几个：--prompt 写画面，--ratio 定画幅，--duration 定时长（默认 5 秒），--resolution 有 720P 和 1080P 两档，--watermark 管角标，--seed 管随机源，--download 直接落盘，--timeout 和 --poll-interval 管轮询。
另外还有 --image、--last-frame、--file、--prime 四条输入路。这轮我一条都没测，所以下面不写它们的结论。视频族在架的模型有 20 个（bl model search --keyword video），我这轮只碰了默认那一个。
帮助文本里 --seed 那一行的说明写的是 "Random seed for reproducible generation"。我就是照着这句话把复现当成了默认能力，后面第五节那两次跑下来，这句话在视频侧不成立。flag 的说明文字能告诉你参数收什么，不总能告诉你它在每个模态上的行为一致，这轮的教训在这。
CLI 装好是一条 npm 命令的事，入口在 CLI 安装页。跑生成要 Key，签发在 API Key 页面。
四、读数一：等待 148 秒，产物规格能核
bl video generate --model wan3.0-video --prompt "黄蓝色调手绘简笔画涂鸦风：白色演示舞台上，一支粗黑轮廓的话筒自己开口说话，声波是浅黄与浅蓝的小线条，镜头缓慢推近" --ratio 16:9 --duration 5 --download ./opening.mp4
第一次跑，148 秒落盘，14.9 MB。ffprobe 读规格：1920×1080、30fps、151 帧，跟 --ratio 16:9 --duration 5 对得上，分辨率走的是默认那一档。
内容我抽帧核过：白舞台、粗黑轮廓的话筒、黄蓝两色小线条声波都在，构图跟 prompt 一致。观感我不评价，那不是我能核的东西；能核的只有主体和规格，这一轮的验收就压在这两件事上。
规格这一步我做成能复跑的：ffprobe 读分辨率、帧率、帧数，跟我传进去的 --ratio 和 --duration 对一遍。151 帧配 30fps 差不多就是 5 秒，账能对上就说明参数真的生效了，不是只回了一个能播的文件。
这一帧右下角坐着「AI 生成」角标，默认就带（1 次抽帧实证），返回的产物 URL 文件名里也写着 watermark。接进品牌演示之前，这一条得先处置。
五、读数二：角标能关，但先撞一堵轮询的墙
bl video generate --model wan3.0-video --prompt "黄蓝色调手绘简笔画涂鸦风：白色演示舞台上，一支粗黑轮廓的话筒自己开口说话，声波是浅黄与浅蓝的小线条，镜头缓慢推近" --ratio 16:9 --duration 5 --watermark false --timeout 900 --download ./opening-clean.mp4
第一次只加 --watermark false、没动 timeout：轮询超时，exit 5，提示我加 --timeout。任务侧没死，是命令等不下去了。把 --timeout 提到 900 重试一次，SUCCEEDED，17.7 MB，规格 1920×1080、30fps、150 帧。同帧位抽帧：默认角标没了（1 次实证）。
写进流程就是两行判据：默认角标要显式 --watermark false 才关得掉；生成时长可能超过默认轮询窗口，timeout 一开始就给足，别等假失败再补。
假失败这一类问题的麻烦在于它长得像真失败。exit 5 出来的时候，第一反应是重跑，重跑又要从头等一轮，一来一回时间就没了。把它当成"等待不够"来处理，比当成"生成失败"来处理省事得多。
六、读数三：seed 在视频侧不复现
我在图像侧试过同一个 seed 连出两次逐像素一致，就默认视频侧也是这一套，还打算靠它做片头的迭代：固定 seed，只改 prompt 里一个词，其余画面不动。
同一段 prompt、--seed 42、--ratio 1:1，连跑两次。一个 9.3 MB，一个 18.6 MB，sha256 不同；规格两边一样，都是 1440×1440、30fps、151 帧。
抽第 0 帧和第 60 帧做像素差，平均绝对差 38 和 36（0–255 口径），差异铺满整幅。这不是编码抖动那一级的差，是两条完全不同的片子。
差是这么算的：两条片子各取同一帧位的图，缩到同尺寸，逐像素求绝对差再取平均。满量程 255 的口径下平均差到三四十，意思就是画面里几乎每个位置都不一样，不是局部飘了几帧。
结论只到现象这一层：这两次里 seed 没有复现同一条片。为什么不复现我不猜，跨模态能不能外推，这轮的答案是不能。工程上的处置很直接：要留同一条片就存文件，文件名带日期和用途；重要片头一次多跑几条再挑。
七、把三个读数落成流程里的三句判据
第一句，排期按等待算。片头这一环不是即时的，一条 5 秒的片子在我这儿是 148 秒（1 次），要挑几条就得按倍数排。
第二句，默认值要显式覆盖。角标缺省在，品牌场合显式 --watermark false；轮询窗口默认值偏短，timeout 一起给足，两个 flag 写在同一行里。
第三句，产物当不可复现资产管。存文件、留 prompt 原文、记跑的次数；seed 只当随机源用，不当版本锁用。
三句话都不复杂，但没跑过之前我一句也写不出来，只能凭感觉排期，出问题再回头找原因。
再算一笔改稿的账。片头这一环以前要三步：找素材、剪、导出，演示稿临发布动了主题色，三步重走一遍，素材还不一定找得到第二条像样的。现在改的是 prompt 里那几个词，重跑一条命令，代价是那两分半的等待。改一次和改三次，两种路线的差距就拉开了。
代价也得记在同一页上：改出来的那一版跟上一版不是同一条片，seed 锁不住。所以改稿这件事在生成路线上是"重抽"，在手做路线上是"返工"，性质不一样，排期的时候别混着算。
八、坑清单，三条带走
- seed 在视频侧不复现（两次实证，帧差 38/36）。要同一条片留文件，别留 seed。
- 生成慢过默认轮询窗口会 exit 5 假失败（1 次）。
--timeout一开始就给足，重试一次通常就通。 - 角标默认带（1 次抽帧实证），要干净版显式
--watermark false（1 次抽帧实证），并且和 timeout 一起给。
你那边文生视频接进流程的时候，等待和 timeout 是怎么定的，seed 有没有对齐过，评论区说一下，我想把这轮的单次读数补成多轮的。
