video-generator — 多模型雲端影片 (Higgsfield)
透過 Higgsfield 產生影片片段 — 該平台將 6 個以上的主流模型整合在單一 API 與帳單帳戶下。根據成本與品質的權衡選擇合適的模型;其餘介面完全相同。
技能目錄(此 SKILL.md 所在位置)在下方簡稱為 $SKILL_DIR。
雲端運算。 無需本機 GPU。需要 Higgsfield 帳號及從 cloud.higgsfield.ai 取得的 API 金鑰。
模式
| 模式 | 觸發條件 | 行為 |
|---|---|---|
text-to-video | input/ 中無圖片 | 僅根據提示詞產生影片 |
image-to-video | input/ 中有圖片 | 將每張圖片動畫化為片段 |
auto (預設) | — | 自動選取上述模式 |
預設集
本技能將預設集作為同一影片引擎上的輕量覆蓋層。預設集可設定預設模型、寬高比、持續時間與提示詞前綴。明確設定的設定值仍優先。
| 預設集 | 最佳用途 | 預設模型 | 預設比例 |
|---|---|---|---|
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之前先選擇一個預設集 - 確認預設集符合期望的輸出風格
- 若使用者未選擇,則保留預設預設集並記錄於設定檔中
- 不要重複疊加相同風格;如果提示詞已符合預設集,則保持提示詞不變
模型
| 金鑰 | 完整模型 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 金鑰 + API 密鑰), 然後使用下列其中一種方式匯出環境變數:
# 選項 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"
Agent 工作流程
1. 詢問使用者
在產生影片前,我需要了解以下資訊:
🎬 模式
- text-to-video(僅提示詞)或 image-to-video(將圖片放入 input/)
- 預設:自動偵測
🎛️ 預設集(預設: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.(僅圖片轉影片)放置圖片
將來源圖片複製到 $SKILL_DIR/input/。支援格式:.jpg .jpeg .png .webp
4. 執行
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. 回報結果
告知使用者:
output/中的輸出檔案路徑- 使用的模型與約略的點數成本
- 影片長度與解析度
設定參考
| 鍵 | 值 | 預設值 | 說明 |
|---|---|---|---|
input_dir | 路徑 | ./input | 來源圖片(僅圖片轉影片) |
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 | 物件 | {} | 傳遞給模型的額外參數 |
常見指令範例
# 文字轉影片,使用預設模型 (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
輸出
每個任務會將一個 .mp4 寫入 output_dir:
- 文字轉影片:
output.mp4 - 圖片轉影片:每個輸入圖片產生
<圖片檔名>.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 更新了路由,可透過設定中的 "extra_params" 覆寫或更新常數即可,無需其他更動。