liven — 图像转视频(云端)
使用运行在 fal.ai 云基础设施上的 LTX-2.3 Fast 视频扩散模型,让静态图像生动起来。提供一张图像和一个运动提示;模型会根据设置生成一个短视频片段(6-20 秒)。
该技能目录(即本 SKILL.md 所在目录)在下文中称为 $SKILL_DIR。
基于云端。 无需本地 GPU。需要
FAL_API_KEY环境变量。 定价:1080p 为 $0.04/秒,1440p 为 $0.08/秒,4K 为 $0.16/秒。
何时使用
在用户想要以下场景时使用此技能:
- 无本地 GPU 的情况下,将照片或插画动画化为短视频
- 为静态图像创建电影级运动效果(例如:缓慢变焦、平移、光线闪烁)
- 从产品照片或人像生成社交媒体视频内容
- 无本地 VRAM 限制的情况下,使用更高分辨率(高达 4K)
设置(仅首次运行)
cd "$SKILL_DIR" && uv sync
设置 FAL_API_KEY 环境变量:
export FAL_API_KEY="your-api-key-here"
代理工作流程
1. 询问用户
在制作动画之前,我需要了解以下信息:
💬 运动提示(必填)
描述您想要的运动,例如:
"缓慢的电影推近镜头,金色光线,微妙的相机漂移"
🎬 片段设置
- duration — 视频长度(秒)(默认:6,可选:6, 8, 10, 12, 14, 16, 18, 20)
注意:时长 >10 秒仅支持 25 FPS 和 1080p
- resolution — 输出质量(默认:1080p,可选:1080p, 1440p, 2160p/4K)
- aspect_ratio — 视频宽高比(默认:auto,可选:auto, 16:9, 9:16)
- fps — 每秒帧数(默认:25,可选:24, 25, 48, 50)
- generate_audio — 生成 AI 音频以匹配视频(默认:true)
📁 输入 / 输出目录(默认:./input 和 ./output)
等待用户回复后再继续。
2. 编辑 config.json
根据用户的选择编写或更新 $SKILL_DIR/config.json。
3. 运行
cd "$SKILL_DIR" && uv run python scripts/img2vid.py --config config.json
4. 报告结果
告知用户:
- 输出文件路径
- 视频时长和分辨率
- 成本估算(基于时长和分辨率)
- 直接下载链接(视频临时托管在 fal.media 上)
配置参考
| 键 | 值 | 默认值 | 描述 |
|---|---|---|---|
input_dir | 路径 | ./input | 存放源图像的文件夹 |
output_dir | 路径 | ./output | 目标文件夹 |
prompt | 字符串 | (必填) | 运动描述 |
duration | 整数 | 6 | 视频时长(秒)(6-20) |
resolution | 字符串 | 1080p | 输出分辨率:1080p, 1440p, 2160p |
aspect_ratio | 字符串 | auto | 宽高比:auto, 16:9, 9:16 |
fps | 整数 | 25 | 每秒帧数:24, 25, 48, 50 |
generate_audio | 布尔值 | true | 为视频生成 AI 音频 |
end_image_url | 字符串 | null | 用于转场视频的可选结束帧 |
常用调用
# 使用运动提示制作动画(使用默认设置:6秒,1080p,25fps)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "缓慢的电影推近镜头,金色光线"
# 生成长度为 10 秒的视频
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "树间微风" --duration 10
# 为社交媒体创建竖屏视频
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "微妙的相机运动" --aspect-ratio 9:16
# 4K 质量(更高成本:$0.16/秒)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "电影级拉远镜头" --resolution 2160p --duration 8
# 更高帧率以实现更平滑的运动
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "快动作序列" --fps 48
# 禁用音频生成
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "静默冥想场景" --no-audio
# 在两幅图像之间创建转场
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "平滑变形转场" \
--end-image /path/to/end_image.jpg
输出
每张输入图像在 output_dir 中生成一个 .mp4 片段,命名为 <图像文件名>.mp4。视频也会临时上传到 fal.media CDN,并在控制台输出中提供下载 URL。
生成后会打印视频元数据(分辨率、fps、时长)。
错误处理
- 缺少 FAL_API_KEY → 显示带有设置说明的明确错误
- 无效的图像格式 → 显示错误信息及支持的格式(PNG, JPEG, WebP, AVIF, HEIF)
- API 错误 → 传播 fal.ai 的错误信息
- 网络问题 → 重试逻辑并显示明确的错误信息
定价参考
| 分辨率 | 每秒价格 |
|---|---|
| 1080p | $0.04 |
| 1440p | $0.08 |
| 2160p (4K) | $0.16 |
示例:
- 6 秒视频,1080p = $0.24
- 10 秒视频,1080p = $0.40
- 10 秒视频,4K = $1.60