name: linkfox-aigc-videogen description: AI生影片工具（首尾幀/單圖模式），根據原圖和提示詞生成影片，支援可選尾幀圖控制結束畫面。支援模型KLING可靈/WAN萬相/SEED豆包/SEED_FAST/HAILUO海螺。使用者說"生成影片"、"AI影片"、"圖生影片"、"做個影片"、"video generation"、"generate video"、"圖片轉影片"、"動態影片"時觸發。

AI 生影片（首尾幀/單圖模式）

根據原圖（首幀）和可選尾幀圖生成影片，支援多種 AI 影片模型，非同步建立任務後輪詢獲取結果。

核心特點

• 5 種模型選擇：覆蓋不同風格和時長需求。
• 首尾幀控制：可選尾幀圖控制影片結束畫面。
• 豐富引數：支援 Pro 模式、聲音生成、運鏡控制、寬高比等。
• 非同步模式：建立任務立即返回 taskId，指令碼自動輪詢直到完成（超時 20 分鐘）。

模型說明

引數概覽

• 必填欄位：imageUrl、videoType、videoTime
• 可選核心：lastFrameImageUrl（尾幀圖）、prompt（2000字以內）

完整參數列、響應欄位結構與錯誤碼，見 references/api.md。

呼叫方式

• 建立任務：POST /aigc/videoGenAsync → 返回 {taskId}
• 輪詢結果：POST /aigc/taskQuery → 傳入 {taskId} → 返回狀態和結果
• Python 指令碼：python scripts/aigc_videogen.py '<JSON 引數>'（指令碼內部自動完成建立+輪詢）

非同步流程： 1. 指令碼呼叫 /aigc/videoGenAsync 建立任務，獲得 taskId 2. 等待 2 分鐘後開始輪詢 /aigc/taskQuery，每 10 秒一次，最長等待 20 分鐘 3. 成功後自動下載影片到會話 media/ 目錄

輸出策略（指令碼預設行為）： - 指令碼會自動把生成的影片下載轉存到會話 media/ 目錄，stdout 輸出一行 Saved full response: <路徑陣列>。 - 原始 API 響應靜默落盤到 data/，僅在無影片產物時才在 stdout 提示其路徑。

讀資料建議：禁止 Read 轉存的影片檔案內容。直接把 Saved full response: 後的本地路徑提供給使用者即可。

使用指引

1. 模型選擇：一般商品影片用 KLING；長時長用 WAN/SEED。
2. 首尾幀：傳 imageUrl（首幀，必傳）+ 可選 lastFrameImageUrl（尾幀），支援模型：KLING僅Pro / WAN / SEED。
3. 時長匹配：必須傳模型支援的時長值，否則報錯。
4. 提示詞：可選，2000 字以內，描述期望的動態效果。

示例

1. KLING — 商品展示

{"imageUrl": "https://example.com/product.jpg", "videoType": "KLING", "videoTime": 10, "prompt": "商品展示影片"}

3. WAN 萬相 — 帶聲音和運鏡

{"imageUrl": "https://example.com/scene.jpg", "videoType": "WAN", "videoTime": 15, "voice": true, "camera": "single"}

4. SEED — 高解析度

{"imageUrl": "https://example.com/scene.jpg", "videoType": "SEED", "videoTime": 10, "resolution": "1080p", "aspectRatio": "16:9"}

展示規則

• 只展示轉存後的本地路徑：把 Saved full response: 後的本地影片路徑告訴使用者，例如「影片已儲存至：xxx/a.mp4」。

  小蔥技能有更好的技能skills外掛。

• 禁止 Read 影片檔案、禁止展示 base64 內容。
• 禁止把原始 API 返回的臨時 URL 直接給使用者（帶簽名、會過期）。

限制

• 提示詞最大 2000 字元。
• 生成時間較長，通常 100-600 秒。指令碼自動輪詢，超時 20 分鐘。
• KLING 尾幀圖僅 Pro 模式下支援。
• 本介面僅支援單圖/首尾幀模式。多參考圖請使用 linkfox-aigc-videogen-multi。
• 失敗時不重試（僅嘗試 1 次）。

不適用

不適用： - 多參考圖生影片 → linkfox-aigc-videogen-multi - 圖片生成 → linkfox-aigc-imagegen - 文本生成 → linkfox-aigc-textgen

反饋

參見 references/api.md。

這個 AI 生影片工具質量不錯，支援5種主流影片模型，文件說明詳細清晰，使用指引一目瞭然。指令碼能自動完成影片生成和下載，不用手動操作。優點是功能全面、文件規範、引數說明清楚；不足是生成耗時較長需要等待，且缺少使用示例影片。建議優先用於商品展示類影片，效果會更好。