AI 影片生成 MCP 伺服器

什麼是 VidFlux 影片 MCP 伺服器？

Model Context Protocol（MCP）是 AI 助理呼叫外部工具的開放標準。VidFlux MCP 是一個託管好的端點，讓你的 AI 助理擁有影片生成工具：發起文字轉影片、圖片轉影片或動作控制任務、查詢進度、取得完成的 MP4。助理會自己寫提示詞、挑模型、決定長度與比例，等算圖完成後把檔案交給你，你不必離開對話或編輯器。

端點背後跑的是和 vidflux.ai 網站完全相同的生成流程，所以模型版本、價格與退點規則都一致，每筆任務也會出現在你的帳號紀錄裡。

支援的 AI 影片模型

在 model 參數填入模型 ID 即可。表中點數為預設設定的價格；影片越長、解析度越高或開啟音訊會越貴，用 dry_run 可以先查到任何設定的精確價格。

用於關鍵影格與封面的圖片模型

先產生或修改首幀、商品圖和影片封面，再交給上方任一款圖片轉影片模型讓它動起來。

快速開始：3 步完成連線

1. 登入 VidFlux，在「設定 → API & MCP」建立一把金鑰。新帳號會附贈免費試用點數。
2. 依照下方設定，把伺服器加進你的 AI 用戶端。
3. 直接開口要影片，例如：「用 Seedance 2 做一支 5 秒、9:16 的拉花慢動作影片，存到 ./assets」。

MCP 用戶端設定

把 vf_your_api_key 換成你的金鑰。支援環境變數的用戶端，建議把金鑰放在 VIDFLUX_API_KEY，不要直接寫在設定檔裡。

Claude Code

claude mcp add --transport http vidflux https://vidflux.ai/api/mcp \
  --header "Authorization: Bearer vf_your_api_key"

# verify
claude mcp list

Claude Desktop

Claude Desktop 需要透過 mcp-remote 以 API 金鑰連線遠端伺服器（需安裝 Node.js）。編輯 claude_desktop_config.json 後重新啟動 Claude：

{
  "mcpServers": {
    "vidflux": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vidflux.ai/api/mcp",
        "--header", "Authorization: Bearer vf_your_api_key"
      ]
    }
  }
}

Cursor

加到 ~/.cursor/mcp.json（所有專案）或 .cursor/mcp.json（單一專案）：

{
  "mcpServers": {
    "vidflux": {
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

OpenAI Codex CLI

export VIDFLUX_API_KEY=vf_your_api_key
codex mcp add vidflux --url https://vidflux.ai/api/mcp \
  --bearer-token-env-var VIDFLUX_API_KEY

VS Code (GitHub Copilot agent mode)

加到 .vscode/mcp.json：

{
  "servers": {
    "vidflux": {
      "type": "http",
      "url": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Windsurf

加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "vidflux": {
      "serverUrl": "https://vidflux.ai/api/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

Cline、Roo Code 與其他用戶端

只要支援 Streamable HTTP 與自訂標頭的用戶端，都能用同一組網址和標頭。只支援 stdio 的用戶端，可以沿用上面 Claude Desktop 的 mcp-remote 寫法。

MCP 工具

影片生成是非同步的，AI 助理通常會這樣執行：

list_models            → seedance-2 (9:16, audio)
generate_video {model: "seedance-2", prompt: "...", aspect_ratio: "9:16",
                duration: 5, dry_run: true}
                       → {"credits_required": 425, "sufficient": true}
generate_video {...same arguments without dry_run}
                       → {"id": "3f1c9e0a-...", "status": "processing"}
get_task {task_id: "3f1c9e0a-..."}   (every 15 s)
                       → {"status": "completed", "video_url": "https://...mp4"}

價格：依用量扣點

• 連線伺服器，以及呼叫 list_models、get_task、get_credits 都不收費。
• 每支影片扣的點數與 vidflux.ai 網站相同（見上方表格）。點數包 500 點 US$4.98 起，買越多單價越低，購買的點數永不過期。
• 加上 dry_run: true 只會驗證參數，並回傳精確價格與餘額是否足夠，不會真的生成。
• 生成失敗或被拒絕的任務會自動退點。

查看點數方案

可以拿來做什麼

VidFlux MCP、各家官方 API、自架開源 MCP 比較

常見問題排除

伺服器顯示已連線，卻看不到影片工具

重新啟動用戶端或重新載入 MCP 伺服器，並確認已切到 Agent 模式（Cursor、VS Code）。Claude Code 可輸入 /mcp 查看工具清單。

出現 401 Unauthorized 或「Missing or invalid API key」

標頭必須是 Authorization: Bearer vf_…。確認金鑰沒有被撤銷，複製時也沒有多帶引號或空白。

出現 402 INSUFFICIENT_CREDITS

餘額低於 dry_run 回傳的價格。請加購點數，或改用較短、較低解析度或較便宜的模型。

影片一直停在 processing

多數影片 1 到 5 分鐘完成；Seedance 2.5 長影片或 4K 的 Gemini Omni 會更久。請繼續呼叫 get_task 查詢。若任務失敗會回傳錯誤並自動退點。

Claude Desktop 出現 spawn npx ENOENT

mcp-remote 需要 Node.js 18 以上。請安裝 Node.js，或在 command 欄位填入 npx 的完整路徑。

參考圖被拒絕

image_urls 必須是公開的 HTTPS 圖片網址（JPG、PNG 或 WebP）。本機檔案路徑和需要登入的連結都無法讀取。

常見問題