@aivideospeed/mcp

讓 Claude Code、Codex 直接用你的 aivideospeed 帳號生成圖片與影片。 跟 AI 說「開一個保溫瓶專案，用桌面的照片做一張白底主圖」或「做一支 5 秒的開箱影片」，成品會存進你的資料夾， 網站上的圖片專案、影片專案也看得到，可以接著在網頁上修改。

安裝

1. 到 aivideospeed.com 的「AI 助手連線」頁產生一把金鑰，頁面上會直接給你組好的安裝指令
2. 在終端機貼上指令執行一次
3. 重新開啟 Claude Code（或 Codex）

電腦需要有 Node.js 18 以上。

# Claude Code（Mac／Linux）
claude mcp add --scope user aivideospeed --env AIVIDEOSPEED_API_KEY=avs_你的金鑰 -- npx -y @aivideospeed/mcp

# Claude Code（Windows）
claude mcp add --scope user aivideospeed --env AIVIDEOSPEED_API_KEY=avs_你的金鑰 -- cmd /c npx -y @aivideospeed/mcp

# Codex
codex mcp add aivideospeed --env AIVIDEOSPEED_API_KEY=avs_你的金鑰 -- npx -y @aivideospeed/mcp

裝好了卻不能用？

AIVIDEOSPEED_API_KEY=avs_你的金鑰 npx -y @aivideospeed/mcp doctor

會用中文告訴你卡在哪一關：Node 版本、金鑰格式、金鑰是否有效、網路連不連得到。

可以做的事

• 每次生成前，AI 會先把模型、點數、參考圖對照與完整提示詞整理給你確認；想快一點就跟它說「接下來直接送，不用問我」
• 有參考圖時，提示詞用 @image1、@image2 指出每張圖的角色（照附圖順序），平台會自動換成各模型的寫法
• 成品預設存在「目前資料夾\專案名稱\」，檔名自動編號，不會覆蓋既有檔案
• 改了提示詞或設定會開新的任務卡，每一版都留在網站上可以比較
• 價格與網頁相同；生成失敗自動退點。影片按秒計費，比圖片貴很多，AI 會先把預估總點數告訴你
• 影片目前只能參考圖片；要參考影片或音檔請到網站上操作
• 成品同時保存在網站的專案裡與你的電腦上

產品圖套組

跟 AI 說「用這張照片幫我做一組保溫瓶的詳情圖」，它會先請平台規劃 9 張圖的場景與文案、整理給你看， 你可以直接說「第 3 張改成戶外露營」「主標題太長」，確認後才生成。做好之後還能針對某一張微調（「標題改成紅色」）。 一組 9 張每張各算一次點數；產品圖的成品在平台只保留 14 天，所以會自動存到你的電腦。

批次改圖

跟 AI 說「把 D:\新品照 這個資料夾裡的圖都換成純白背景」，它會先告訴你有幾張、要花幾點，確認後整批送出， 做好的圖存成「原檔名-改-01」，不會動到原圖。建議先挑一兩張試，滿意再跑整批。 每張各算一次點數；成品在平台只保留 14 天，所以會自動存到你的電腦。

Meta 廣告圖與影片廣告

跟 AI 說「用這張產品照幫我做 Meta 廣告圖」，它會先請平台發想幾組不同的廣告訴求與文案給你挑，確認後才生成； 預設 3 組訴求、1:1，要加 4:5 或 9:16 版位、要更多組都可以說。 做好的廣告圖還能接著說「把第 1 張做成動態廣告」：平台會分析出 3 組「只讓局部動起來」的方案，文字與 Logo 全程鎖住不動， 挑一組生成 5～15 秒的影片（影片按秒計費，比圖片貴很多，AI 會先算給你看）。

銷售頁

跟 AI 說「用這幾張產品照幫我做一頁銷售頁」，它會先請平台規劃整頁的區塊（首圖、痛點、解決方案……到行動呼籲）與文案給你看， 確認後一張一張依序生成——每一張都延續上一張的風格，照編號由上往下拼起來就是一整頁。 因為要依序做，6 張大約 5～8 分鐘。設計師可以先加一張品牌色卡當整頁的配色基準。

UGC 真人帶貨影片

跟 AI 說「用這張人像和這張產品照做一支帶貨影片」，它會先合成一張真人拿著產品的帶貨圖給你看， 滿意之後請平台寫出動作與台詞，確認後才生成影片。預設用 Kling 3.0；想省點數可以請它改用 Grok。

產品廣告影片

跟 AI 說「幫我做一支保溫瓶的廣告」，講一下產品特點、想要的主角與氛圍，平台會設計創意並寫出分鏡腳本； 確認後先畫成一張分鏡板給你看，滿意才生成影片。影片預設 480p、15 秒，要更高畫質或更短都可以說。

金句影片

給 AI 一張風格參考圖和一段金句（300 字內），平台會把全文拆成一段段並設計每段的畫面； 確認後每段先出一張圖給你看，滿意才把每張圖變成 6 秒影片。影片預設 480p。 成品是每段各自的圖與影片（沒有聲音），存在專案資料夾裡，並附一份每段文字的清單，方便剪接上字幕。

知識影片

跟 AI 說「幫我做一支講黑洞的知識影片，一分鐘」，最好再附一張喜歡的畫風圖。平台會先寫旁白腳本，AI 會給你看全文並提出修改建議； 確認後切成分鏡，AI 會把每個分鏡的畫面與動態描述潤過一次，再給你看分鏡表與點數。 同意後每個分鏡先出一張圖，AI 會逐張檢查主角前後是否一致、畫面有沒有對上旁白，把有問題的列給你； 可以請它以現有的圖修正、改提示詞重畫，或直接換成你自己的圖。滿意才做影片。總長度預設 1 分鐘、最長 3 分鐘（平台寫的腳本通常會比設定的長，AI 會先告訴你實際是幾個分鏡、幾點）； 影片預設 480p，也可以指定 Vidu Q4、Kling 3.0 等較貴的模型。 成品是每個分鏡各自的圖與影片，並附一份旁白文字清單，方便剪接上字幕與配音。

虛擬網紅

給 AI 一張人像照片，跟它一起把口播腳本寫好（600 字內、日常講話的方式）。平台會把腳本拆成一段段， AI 會替每一段寫好場景與動作的提示詞，整理成分段表給你確認。同意後每段先出一張場景圖，AI 會逐張檢查是不是同一個人、 前後有沒有一致；滿意才做影片，影片裡人物會開口講那一段台詞。 影片預設用最便宜的 Grok 480p，遇到中文破音字可能唸錯；在意發音可以請它改用 Kling 3.0。

Podcast 訪談影片

給 AI 一張訪談感的人像，跟它一起把口播腳本寫好。全片都是同一個畫面、固定機位，人物坐著把腳本一段段講完， 像 Podcast 或訪談錄影。不用另外生場景圖，所以比虛擬網紅便宜。沒有人像的話，可以請 AI 先用圖片專案生一張。

長片素材

適合 3～10 分鐘、有故事的內容。跟 AI 說主題與長度，最好附一張喜歡的畫風圖。它會先寫大綱給你確認， 再列出會反覆出現的角色與場景、各生一張參考圖，接著每段寫旁白、切成鏡頭，最後每個鏡頭生一張圖。 做出來的是素材（旁白稿與圖），不會出影片，讓你拿去剪輯；旁白可以另外請它配音。

大導演劇場

適合重視事實正確的知識影片。給 AI 一個主題，或直接貼一整篇文章，平台會上網做研究考據並附上來源； AI 整理給你看、確認方向後寫出有章節的導演腳本，並替你把腳本裡的數字、年份、人名對照來源檢查一次，再拆成一顆顆鏡頭。 到拆好鏡頭為止都不扣點。確認後依序生成：先配音，再出圖（系列沒有風格參考圖時會先出第一張給你看，它是整支片的風格基準）， 最後出片——影片長度會跟著配音。3 分鐘大約 18 顆鏡頭、1,400 點上下。成品只在平台保留 14 天，AI 會幫你存到電腦裡。

走位排練室

想讓生成的影片照你要的走位與鏡頭演，而不是靠運氣重抽？跟 AI 說這段戲幾秒、有誰、怎麼走、鏡頭怎麼拍， 它會排出一段方塊人形的 3D 動畫，給你一個網頁連結。打開看，哪裡不對就直接說（「跳高一點」「第二個鏡頭拉近」），它改完你重新整理就看得到。 滿意後在網頁上按「匯出 MP4」，連同自動組好的提示詞一起拿去當影片模型的參考影片。整個過程不扣點，影片在你的瀏覽器裡算。

短劇導演室

有角色、有台詞的短劇與短片。跟 AI 說一句話題材（或直接貼你自己的劇本），它會先跟你確認整集多長、用哪一支影片模型，並把點數算給你聽—— 點數是「每秒單價 × 整集總秒數」，預設的 Seedance 2 mini 480p 每秒 8 點，90 秒一集約 720 點；Seedance 2.5 影片效果最好，每秒 56 點。 接著平台寫出大綱與要準備的人物、道具、場景，你確認後再寫成劇本；短劇可以一集一集往下寫，每一集都會接上一集的懸念。 到劇本寫好為止都不扣點。劇本定案後，AI 會替每個人物、道具、場景寫設定卡（不扣點）給你確認，再出參考圖（每張 12 點）； 人物是一張定妝板，之後每一段影片都照它，角色才會長得一樣。你也可以給 AI 自己的人物或產品照片。 資產圖確認後，平台把劇本切成一段一段、替每一段寫好提示詞（都不扣點），AI 檢查過再出片。 影片最貴，所以會先只出第 1 段給你看；人物、畫面、聲音都對了再出其餘的。每一段是一支獨立的影片，AI 會照順序存到電腦裡，接起來就是完整的一集。

音樂

跟 AI 說想做什麼歌：用途（品牌主題曲、廣告配樂、短影音背景…）、想要的感覺、要不要人聲、大概多長。 它會跟你一起把歌詞寫好（只要配樂就不用歌詞），確認後生成；一次 24 點，會得到兩首不同的版本，存成 MP3。 想用自己的聲音唱，要先到網站的音樂編曲錄音間建立聲音（需要本人錄音並勾同意），之後就能請 AI 選用。

網紅 VLOG

先給 AI 一張角色參考圖建立一個系列，之後這個系列的每支影片都是同一個人。跟它說想拍什麼（日常、旅拍、GRWM…）、 要 15 秒還是 30 秒，有場景照片可以一起附上。它會寫好五段式的提示詞給你確認，再一次生成一整支有鏡頭切換的影片。 預設用效果最好的 Seedance 2.5（15 秒約 840 點）；想省點數可以請它改用 Seedance 2 Mini 或 WAN 3.0。 成品只在平台保留 14 天，AI 會幫你存到電腦裡。

真人配音影片

給 AI 一張人物照（正面、臉清楚）和一份口播稿，選一個聲音——可以是你自己上傳的聲音。它會把稿子拆段， 每段先用那個聲音配音，再讓照片裡的人對著嘴把那一段講出來；中間可以穿插示意畫面（B-roll）。 講話影片最貴（每秒 25 點，60 秒的稿子約 1,500 點），所以 AI 會先配音請你聽過、先做第一段給你看，滿意才做其他段。

配音與對嘴

金句影片、知識影片、虛擬網紅、訪談影片、長片素材都可以配音。跟 AI 說「幫這個專案配音」，它會列出可以選的聲音 （內建的中文、英文、日文、韓文男女聲，或你自己上傳的），你挑一個，它算好點數給你確認後才送出。 配音很便宜，大約每秒 1 點。

想用自己的聲音：到網站的專案頁點「配音的聲音」→「上傳新的聲音」，填這是誰的聲音並勾同意。 AI 不能替你上傳，但上傳之後它就選得到。

虛擬網紅與訪談影片的影片本來就有人聲。想換成你選的聲音，要先配音、再「對嘴」讓嘴型對上。 對嘴很貴（每秒 28 點，一段大約 140～220 點），AI 不會主動做，你明講要它才會算點數給你確認；建議先做一段看效果。

環境變數

金鑰安全

金鑰就像密碼：不要貼進任何聊天（包括 AI 對話），上課投影時先關掉顯示金鑰的視窗。 不見了或被看到，就到「AI 助手連線」頁撤銷、再產生一把新的。