videoagent-video-studio

🎬 VideoAgent Video Studio

使用時機： 使用者要求生成影片、從文字建立影片、將圖片動畫化、製作短片段或產生 AI 影片。

使用 7 種後端引擎生成短篇 AI 影片。此技能會自動選擇正確模式（文字轉影片或圖片轉影片）、優化提示詞以獲得最佳效果，並回傳影片網址。

---

快速參考

使用者意圖	模式	典型長度
"製作一段...的影片"（無圖片）	text-to-video	4–10 秒
"將這張圖片動畫化" / "讓這個動起來"	image-to-video	4–6 秒
"把這個變成影片，加上..."	image-to-video	4–6 秒
電影感、故事、廣告	偏好 text-to-video 搭配詳細提示詞	5–10 秒

生成模式

模式	說明	支援模型
text-to-video	僅文字提示 → 影片	minimax, kling, veo, hunyuan, grok, seedance
image-to-video	單張圖片 + 提示詞 → 動畫片段	minimax, kling, veo, pixverse, grok, seedance
reference-based	參考圖片/影片 → 一致性輸出	minimax, kling, veo, hunyuan, grok, seedance

模型（使用 --model <id>）

模型 ID	T2V	I2V	參考素材	備註
minimax	✅	✅	✅	主體參考圖片，角色一致性
kling	✅	✅	✅	多元素 / 角色 / 關鍵影格 (O3)
veo	✅	✅	✅	Google Veo 3.1，多張參考圖片
hunyuan	✅	—	✅	影片轉影片風格轉換
pixverse	—	✅	—	風格化圖片轉影片
grok	✅	✅	✅	透過參考影片進行影片編輯
seedance	✅	✅	✅	Seedance 1.5 Pro，同步音訊，4–12 秒

完整模型細節與端點參考：references/models.md

---

如何生成影片

步驟 1 — 選擇模式並優化提示詞

• 文字轉影片：擴充主體、動作、鏡頭運動、光線與風格。具體描述動態（例如「鏡頭緩慢推近」、「角色從左向右走」）。
• 圖片轉影片：描述要套用到圖片的動作（例如「微風吹拂頭髮」、「鏡頭橫掃場景」）。提示詞模式請參考 references/prompt_guide.md。

步驟 2 — 執行腳本

文字轉影片：

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "<優化後的提示詞>" \
  --duration <秒數> \
  --aspect-ratio <比例>

圖片轉影片：

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "<動作描述>" \
  --image-url "<公開圖片網址>" \
  --duration <秒數> \
  --aspect-ratio <比例>

參數說明：

參數	預設值	說明
--mode	text-to-video	text-to-video 或 image-to-video
--prompt	(必填)	場景或動作描述
--image-url	—	圖片轉影片時必填；公開圖片網址
--duration	5	影片長度（秒），通常 4–10
--aspect-ratio	16:9	16:9、9:16、1:1、4:3、3:4
--model	auto	模型 ID（例如 kling、veo、grok、seedance）；auto 由代理伺服器自動選擇

其他指令：

指令	說明
node tools/generate.js --list-models	列出代理伺服器可用的模型
node tools/generate.js --status --job-id <id>	檢查非同步任務狀態

步驟 3 — 回傳結果

腳本會回傳 JSON：

{
  "success": true,
  "mode": "text-to-video",
  "videoUrl": "https://...",
  "duration": 5,
  "aspectRatio": "16:9"
}

將 videoUrl 提供給使用者。

---

對話範例

使用者： "生成一段貓在雨中行走的短影片，要有電影感。"

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "一隻貓在雨中行走，潮濕的街道，霓虹倒影，電影級燈光，慢動作，4K" \
  --duration 5 \
  --aspect-ratio 16:9

---

使用者： "將這張照片動畫化" (使用者上傳一張風景照)

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --prompt "雲朵緩緩飄過天空，草叢輕微搖曳，電影氛圍" \
  --image-url "https://..." \
  --duration 5 \
  --aspect-ratio 16:9

---

使用者： "製作一段 10 秒的直式影片，內容是咖啡沖泡過程，慢動作。"

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --prompt "特寫鏡頭，咖啡倒入白色杯子，慢動作，蒸氣上升，柔和燈光，產品拍攝" \
  --duration 10 \
  --aspect-ratio 9:16

---

使用者： "用 Google Veo 生成一個電影感鏡頭。"

node {baseDir}/tools/generate.js \
  --mode text-to-video \
  --model veo \
  --prompt "龍在雲端飛翔，電影級燈光，8 秒" \
  --duration 8 \
  --aspect-ratio 16:9

---

使用者： "將這張肖像照動畫化。"

node {baseDir}/tools/generate.js \
  --mode image-to-video \
  --model grok \
  --prompt "淺淺微笑，頭部微微轉動" \
  --image-url "https://..." \
  --duration 5

---

設定

預設無需 API 金鑰。 請求會透過託管代理伺服器處理。若要使用自訂代理伺服器或權杖，請設定以下變數：

變數	必填	說明
VIDEO_STUDIO_PROXY_URL	否	代理伺服器基礎網址
VIDEO_STUDIO_TOKEN	否	代理伺服器要求的驗證權杖

---

知識庫

• references/prompt_guide.md — 文字轉影片與圖片轉影片的提示詞模式。
• references/models.md — 模型列表、功能與選擇指南。
• references/calling_guide.md — 各模型端點細節、輸入參數與特殊處理方式。