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. ユーザーに質問
画像をアニメーション化する前に、以下の情報を教えてください:
💬 モーションプロンプト(必須)
希望する動きを説明してください。例:
"slow cinematic push-in, golden hour light, subtle camera drift"
🎬 クリップ設定
- 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. 結果の報告
ユーザーに以下の情報を伝えます:
- 出力ファイルのパス
- 動画の長さと解像度
- コスト見積もり(長さと解像度に基づく)
- 直接ダウンロードURL(動画は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 "slow cinematic push-in, golden hour light"
# 10秒の長い動画を生成
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "gentle wind in the trees" --duration 10
# ソーシャルメディア用の縦型動画を作成
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "subtle camera movement" --aspect-ratio 9:16
# 4K品質(高コスト:$0.16/秒)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "cinematic zoom out" --resolution 2160p --duration 8
# より滑らかな動きのための高いフレームレート
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "fast action sequence" --fps 48
# オーディオ生成を無効化
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "silent meditation scene" --no-audio
# 2つの画像間のトランジションを作成
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "smooth morphing transition" \
--end-image /path/to/end_image.jpg
出力
各入力画像から、output_dirに<画像ファイル名>.mp4という名前の.mp4クリップが1つ生成されます。動画は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