video-generator — マルチモデルクラウド動画 (Higgsfield)
Higgsfield を介して動画クリップを生成します。Higgsfieldは、6つ以上の主要モデルを1つのAPIと課金アカウントで統合するプラットフォームです。コストと品質のトレードオフに応じて適切なモデルを選択してください。それ以外のインターフェースは同一です。
このSKILL.mdが存在するスキルディレクトリを、以下 $SKILL_DIR と表記します。
クラウドベース。 ローカルGPUは不要です。Higgsfieldのアカウントと cloud.higgsfield.ai のAPIキーが必要です。
モード
| モード | トリガー | 動作 |
|---|---|---|
text-to-video | input/ に画像がない場合 | プロンプトのみから動画を生成 |
image-to-video | input/ に画像がある場合 | 各画像をアニメーション化してクリップに |
auto (デフォルト) | — | 上記のモードを自動選択 |
プリセット
このスキルは、同じ動画エンジン上に薄いオーバーレイとしてプリセットを使用します。プリセットは、デフォルトのモデル、アスペクト比、 duration、およびプロンプトプレフィックスを設定できます。明示的な設定値が優先されます。
| プリセット | 最適な用途 | デフォルトモデル | デフォルトのアスペクト比 |
|---|---|---|---|
cinematic (デフォルト) | 汎用シネマティック動画 | kling | 16:9 |
social-hook | スクロールを止める短尺動画 | seedance | 9:16 |
motion-design-ad | SaaS/プロダクトモーション広告 | kling | 16:9 |
ecommerce-ad | 製品プロモーションクリップ | kling | 9:16 |
brand-story | 創業者/ブランドのストーリーテリング | kling | 16:9 |
product-360 | 製品単体のショーケース | kling | 1:1 |
ワークフロールール:
config.jsonを編集する前にプリセットを選択する- プリセットが目的の出力スタイルに合っていることを確認する
- ユーザーが選択しなかった場合は、デフォルトのプリセットを維持し、configに記録する
- 同じスタイルを二重に適用しない。プロンプトがすでにプリセットと一致している場合は、プロンプトをそのまま維持する
モデル
| キー | 完全なモデルID | 最適な用途 |
|---|---|---|
kling (デフォルト) | kling-video/v2.1/pro/image-to-video | リアルな動き、コスト効率 |
seedance | bytedance/seedance/v1/pro/image-to-video | ネイティブ音声同期 |
dop | higgsfield-ai/dop/standard | シネマスタジオ光学物理 |
dop-preview | higgsfield-ai/dop/preview | シネマスタジオ (プレビューティア) |
これらは公式ドキュメントで確認されたモデルIDです。追加のモデル (Sora、Veo、Wanなど) は cloud.higgsfield.ai/explore で見つけることができます。 追加するには、
generate.pyのMODEL_IDSに挿入し、--modelエイリアスを追加します。クレジットは、成功した生成に対してのみ課金されます。失敗したリクエストとNSFWリクエストは返金されます。
セットアップ (初回のみ)
cd "$SKILL_DIR" && uv sync
cloud.higgsfield.ai から認証情報 (API Key + API Secret) を取得し、以下のいずれかの形式でエクスポートします:
# オプション A — 結合 (推奨)
export HF_KEY="your-api-key:your-api-secret"
# オプション B — 別々の変数
export HF_API_KEY="your-api-key"
export HF_API_SECRET="your-api-secret"
エージェントワークフロー
1. ユーザーに確認する
動画を生成する前に、以下の情報が必要です:
🎬 モード
- text-to-video (プロンプトのみ) または image-to-video (画像を input/ にドロップ)
- デフォルト: auto-detect
🎛️ プリセット (デフォルト: cinematic)
- cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360
- config.json を書き込む前に選択を確認する
- 省略された場合は、デフォルトのプリセットを維持し、その選択を記録する
🤖 モデル (デフォルト: kling)
kling · seedance · dop · dop-preview
推奨: 速度/コスト重視なら kling、品質重視なら seedance
💬 プロンプト (必須)
動きやシーンを説明してください。例:
"スローなシネマティックプッシュイン、暖かなゴールデンアワーの光、微妙なカメラのドリフト"
⚙️ 設定
- duration — 動画の長さ (秒単位) (デフォルト: 6、範囲: 3–16)
- aspect_ratio — 16:9 · 9:16 · 1:1 (デフォルト: 16:9)
- resolution — 720p · 1080p (デフォルト: 1080p)
ユーザーの応答を待ってから次に進みます。
2. config.json を編集する
ユーザーの選択に基づいて $SKILL_DIR/config.json を書き込むか更新します。デフォルトを使用する場合でも、preset を明示的に設定します。
3. (image-to-video のみ) 画像を配置する
ソース画像を $SKILL_DIR/input/ にコピーします。対応形式: .jpg .jpeg .png .webp
4. 実行する
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. 結果を報告する
ユーザーに以下を伝えます:
output/内の出力ファイルパス- 使用したモデルとおおよそのクレジットコスト
- 動画の duration と resolution
設定リファレンス
| キー | 値 | デフォルト | 説明 |
|---|---|---|---|
input_dir | パス | ./input | ソース画像 (image-to-video のみ) |
output_dir | パス | ./output | MP4の出力先 |
mode | auto · text-to-video · image-to-video | auto | 生成モード |
preset | cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360 | cinematic | クリエイティブプリセットオーバーレイ |
model | kling · seedance · dop · dop-preview | kling | 使用するモデル |
prompt | 文字列 | (必須) | 動きやシーンの説明 |
duration | 整数 3–16 | 5 | 動画の長さ (秒) |
aspect_ratio | 16:9 · 9:16 · 1:1 | 16:9 | 出力アスペクト比 |
extra_params | オブジェクト | {} | モデルAPIへのパススルーパラメータ |
一般的な呼び出し例
# テキスト→動画、デフォルトモデル (kling)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "霧のかかった山々の日の出のドローンショット" --duration 8
# 画像→動画、Kling使用 (事前に画像を input/ にドロップ)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "スローなシネマティックプッシュイン、ゴールデンアワーの光" --model kling
# 高品質: Seedance
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "夜明けの霧の街の上の航空パルバック" --model seedance
# Reels/TikTok向け縦型動画
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "トーキングヘッド、自然なボケ背景" \
--aspect-ratio 9:16 --model kling
# 高速ドラフト: 低解像度、短尺
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "暗い背景でのプロダクトリビール" \
--resolution 720p --duration 4 --model dop-preview
出力
各ジョブは output_dir に1つの .mp4 を書き込みます:
- text-to-video:
output.mp4 - image-to-video: 入力画像ごとに
<image_stem>.mp4
animate-image との比較
animate-image | video-generator | |
|---|---|---|
| プロバイダー | fal.ai | Higgsfield |
| モード | 画像→動画のみ | テキスト→動画 + 画像→動画 |
| モデル | LTX-2.3 Fast (固定) | Kling, Sora, Veo, Wan, Seedance, MiniMax |
| 速度 | 非常に高速 | モデル依存 |
| 最大解像度 | 4K | 1080p |
| シネマティック制御 | なし | extra_params 経由 |
画像からの高速で安価な高解像度クリップには animate-image を使用してください。
テキスト→動画、モデル選択、またはHiggsfieldのシネマスタジオ物理制御が必要な場合は video-generator を使用してください。
API ノート
このスキルは、Higgsfield REST API (cloud.higgsfield.ai) と直接通信します。
モデルエンドポイントパスは generate.py の先頭にある MODEL_ENDPOINTS で定義されています。
Higgsfieldがルートを更新した場合は、configの "extra_params" で上書きするか、定数を更新してください。他の変更は不要です。