liven — 圖像轉影片(雲端)
使用執行於 fal.ai 雲端基礎架構上的 LTX-2.3 Fast 影片擴散模型,將靜態影像賦予生命。提供一張影像與一段動作提示詞;模型會根據設定產生短影片剪輯(6-20 秒)。
此技能目錄(SKILL.md 所在位置)以下簡稱 $SKILL_DIR。
基於雲端。 本機無需 GPU。需要
FAL_API_KEY環境變數。 定價:$0.04/秒(1080p),$0.08/秒(1440p),$0.16/秒(4K)。
使用時機
當使用者想要以下功能時,可使用此技能:
- 將照片或插圖動畫化為短影片,無需本機 GPU
- 從靜態影像產生電影運鏡(例如:慢速推近、平移、光線閃爍)
- 從產品照或肖像產生社群媒體影片內容
- 使用更高解析度(最高 4K),不受本機 VRAM 限制
設定(僅首次執行)
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 剪輯,命名為 <image_stem>.mp4。該影片也會暫時上傳至 fal.media CDN,並在控制台輸出中提供下載網址。
影片中繼資料(解析度、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