用途：通过单一 CLI（bun scripts/main.ts）生成短视频，支持文生视频与图生视频（含首帧、部分提供商支持尾帧控制），无需逐个对接不同提供商的 API。
主要能力：覆盖约 10 家视频模型提供商（Sora、Veo 2/3、Runway Gen-3/Gen-4、Pika 2.2、Luma Dream Machine/Ray 2、FAL 上的 Kling/Wan/Veo/Sora 等）。所有提供商均为异步：CLI 提交任务、轮询直到完成，再下载 MP4 或 WebM，并输出包含 provider、model、video 路径、size_bytes、format 的 JSON。
使用方式： 文生视频：bun scripts/main.ts --prompt "..." --ar 16:9 --duration 5 --video ./out.mp4 图生视频：bun scripts/main.ts --prompt "..." --image ./keyframe.png --duration 5 --video ./out.mp4 指定提供商：加 --provider ark（或 google、runway、fal、luma 等）。 常见参数：--prompt（建议双引号）、--image/--last-frame（本地路径，自动转 data URI）、--duration（默认 5 秒）、--ar（16:9 / 9:16 / 1:1 / 4:3 / 3:4）、--resolution（480p/720p/1080p）、--poll-timeout（默认 600 秒）。 提供商选择顺序为：显式 --provider、EXTEND.md 的 default_provider、按环境变量自动检测（fal > ark > minimax > runway > luma > pika > vidu > google > bailian > openai）。
前置检查：需找到 EXTEND.md（路径依次为 ./.happy-skills/happy-video-gen/EXTEND.md、$XDG_CONFIG_HOME/happy-skills/happy-video-gen/EXTEND.md、~/.happy-skills/happy-video-gen/EXTEND.md），否则运行 bun scripts/main.ts --setup；需确认至少一家提供商已配置凭据，并安装 Bun（缺失时可用 npx -y bun）。
限制：视频生成成本约为图像生成的 10–100 倍，生成 1080P 或 10 秒片段前应先确认费用区间。--last-frame 仅 Luma 与部分 FAL 端点支持；--resolution 并非所有提供商都遵守，低价档通常上限 720p；时长上限因提供商而异（Sora-2/Kling、Seedance 最高 10 秒，Luma 最高 9 秒）。轮询超时会抛出含提供商外部任务 id 的错误，可按参考资料中的异步协议恢复。低价档并发限制严格（常为 1），等待期间勿重复提交同一提供商任务。若用户明确使用即梦/dreamina CLI 应改用 happy-dreamina，若只要静态图应改用 happy-image-gen。具体各提供商的成本与配额细节请参见随附 references/providers.md。