# @aivideospeed/mcp 中文文档

规范地址：https://npmcn.com/package/%40aivideospeed/mcp/

版本：0\.44\.0
npm 元数据更新时间：2026-11-02T10:17:46.255Z
中文译文更新时间：2026-11-06T02:52:23.023Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aivideospeed/mcp
原文对照：https://npmcn.com/package/%40aivideospeed/mcp/?lang=original
项目主页：https://aivideospeed.com/dashboard/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：641 kB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-10-10T02:17:08.441Z
- 最新版本发布：2026-11-02T10:17:46.070Z
- 近 30 天下载量：6072（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 47 个）

## 中文简介

aivideospeed MCP server：讓 Claude Code、Codex 直接用你的 aivideospeed 帳號生成圖片與影片，成品存進本機資料夾，網站的專案裡也看得到。

## 安装

```sh
npm install @aivideospeed/mcp
```

也可以使用：`pnpm add @aivideospeed/mcp`、`yarn add @aivideospeed/mcp`、`bun add @aivideospeed/mcp`

## README

# @aivideospeed/mcp

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

## 安裝

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

電腦需要有 [Node.js](https://nodejs.org/) 18 以上。

```bash
# 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
```

## 裝好了卻不能用？

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

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

## 可以做的事

| 工具 | 說明 | 扣點 |
| --- | --- | --- |
| `list_models` | 圖片或影片的可用模型、比例、畫質、秒數、價格 | 否 |
| `get_balance` | 剩幾點、這把金鑰今天用了多少 | 否 |
| `list_projects` | 我的圖片專案與影片專案 | 否 |
| `create_project` | 開新的圖片專案或影片專案 | 否 |
| `generate_image` | 開一張新任務卡並生成圖片 | **是** |
| `generate_video` | 開一張新任務卡並生成影片（每秒計費） | **是** |
| `generate_more` | 圖片：同一張任務卡、同樣設定再來一張 | **是** |
| `wait_for_image` | 等圖做好並存到本機 | 否 |
| `wait_for_video` | 等影片做好並存到本機（通常 1～10 分鐘） | 否 |
| `download_project` | 把整個專案的成品抓下來 | 否 |
| `get_cloud_storage` | 平台雲端（作品庫）已用多少、上限多少、快過期幾個 | 否 |
| `save_to_cloud` | 把專案的成品永久存到平台雲端（作品庫），不會 14 天後消失；空間不夠整批不存 | 否 |
| `create_product_shot_project` | 產品圖套組：開專案並上傳產品照 | 否 |
| `plan_product_shots` | 產品圖套組：規劃 9 張的場景與圖上文案 | 否 |
| `generate_product_shots` | 產品圖套組：生成整組（或其中幾張） | **是** |
| `wait_for_product_shots` | 產品圖套組：等整組做好並存到本機 | 否 |
| `edit_product_shot` | 產品圖套組：微調或重畫其中一張 | **是** |
| `bulk_edit_images` | 批次改圖：同一個指令套到一整批圖（可給整個資料夾，一批最多 50 張） | **是** |
| `wait_for_bulk_edit` | 批次改圖：等整批做好並存到本機 | 否 |
| `redo_bulk_edit_item` | 批次改圖：重做其中一張，可換指令 | **是** |
| `create_meta_ad_project` | Meta 廣告圖：開專案並上傳產品圖（可加風格參考圖） | 否 |
| `plan_meta_ads` | Meta 廣告圖：發想幾組廣告訴求與文案 | 否 |
| `generate_meta_ads` | Meta 廣告圖：生成（訴求組數 × 版位尺寸數） | **是** |
| `wait_for_meta_ads` | Meta 廣告圖：等整組做好並存到本機 | 否 |
| `edit_meta_ad` | Meta 廣告圖：微調或重畫其中一張 | **是** |
| `analyze_ad_images` | Meta 影片廣告：上傳廣告圖，分析出每張 3 組動態方案 | 否 |
| `generate_ad_videos` | Meta 影片廣告：用挑好的方案生成影片（每秒計費） | **是** |
| `wait_for_ad_videos` | Meta 影片廣告：等影片做好並存到本機 | 否 |
| `create_sales_page_project` | 銷售頁：開專案並上傳產品圖 | 否 |
| `plan_sales_page` | 銷售頁：規劃整頁每個區塊的畫面與文案 | 否 |
| `generate_sales_page` | 銷售頁：依序一張張生成並存到本機（可選品牌色卡） | **是** |
| `edit_sales_page_block` | 銷售頁：改某一個區塊的文案或畫面，可重做 | 重做時**是** |
| `create_ugc_image` | UGC 真人帶貨：真人照＋產品照合成帶貨圖 | **是** |
| `write_ugc_video_script` | UGC 真人帶貨：看圖寫影片腳本與台詞 | 否 |
| `generate_ugc_video` | UGC 真人帶貨：用帶貨圖生成帶貨影片（每秒計費） | **是** |
| `wait_for_ugc` | UGC 真人帶貨：等帶貨圖或影片做好並存到本機 | 否 |
| `write_ad_video_script` | 產品廣告影片：設計創意並寫分鏡腳本 | 否 |
| `generate_ad_storyboard` | 產品廣告影片：把腳本畫成一張分鏡板 | **是** |
| `generate_ad_video` | 產品廣告影片：照分鏡板生成廣告影片（每秒計費） | **是** |
| `wait_for_ad_video` | 產品廣告影片：等分鏡板或影片做好並存到本機 | 否 |
| `plan_quote_video` | 金句影片：讀風格參考圖、把金句全文拆段並寫好每段畫面 | 否 |
| `generate_quote_images` | 金句影片：每段生成一張圖 | **是** |
| `generate_quote_videos` | 金句影片：每段生成一支 6 秒影片 | **是** |
| `wait_for_quote_video` | 金句影片：等圖或影片做好並存到本機 | 否 |
| `write_knowledge_script` | 知識影片：依主題寫旁白腳本（也可以用自己的腳本） | 否 |
| `plan_knowledge_scenes` | 知識影片：把腳本切成分鏡並寫好提示詞 | 否 |
| `generate_knowledge_images` | 知識影片：每個分鏡生成一張圖 | **是** |
| `generate_knowledge_videos` | 知識影片：每個分鏡生成一支影片 | **是** |
| `wait_for_knowledge_video` | 知識影片：等圖或影片做好並存到本機 | 否 |
| `fix_knowledge_scene_image` | 知識影片：以現有的圖修正一個分鏡（例如把主角換成參考圖的造型） | **是** |
| `set_knowledge_scene_image` | 知識影片：把自己的圖直接指定成某個分鏡的圖 | 否 |
| `plan_idol_video` | 虛擬網紅：上傳人像、把口播腳本拆段 | 否 |
| `generate_idol_images` | 虛擬網紅：每段生成一張場景圖 | **是** |
| `generate_idol_videos` | 虛擬網紅：每段生成一支會講話的影片 | **是** |
| `set_idol_scene_image` | 虛擬網紅：把自己的圖直接指定成某一段的場景圖 | 否 |
| `wait_for_idol_video` | 虛擬網紅：等場景圖或影片做好並存到本機 | 否 |
| `plan_podcast_video` | Podcast 訪談影片：上傳人像、把口播腳本拆段 | 否 |
| `generate_podcast_videos` | Podcast 訪談影片：每段生成一支固定機位的講話影片 | **是** |
| `wait_for_podcast_video` | Podcast 訪談影片：等影片做好並存到本機 | 否 |
| `plan_longform` | 長片素材：依主題寫分段大綱 | 否 |
| `plan_longform_assets` | 長片素材：確認大綱，列出會反覆出現的角色、道具、場景 | 否 |
| `generate_longform_assets` | 長片素材：確認清單，每項生成一張參考圖 | **是** |
| `write_longform_scripts` | 長片素材：每段寫旁白並切成鏡頭 | 否 |
| `generate_longform_images` | 長片素材：每個鏡頭生成一張圖 | **是** |
| `wait_for_longform` | 長片素材：等參考圖或鏡頭圖做好並存到本機 | 否 |
| `create_director_series` | 大導演劇場：建立或更新系列（風格、攝影語言、旁白聲音） | 否 |
| `plan_director_video` | 大導演劇場：開一支影片並上網做研究考據 | 否 |
| `write_director_script` | 大導演劇場：寫導演腳本或修改腳本 | 否 |
| `plan_director_shots` | 大導演劇場：把腳本拆成鏡頭或修改鏡頭 | 否 |
| `get_director_video` | 大導演劇場：查一支影片目前的內容與進度 | 否 |
| `generate_director_audio` | 大導演劇場：替每顆鏡頭配音 | **是** |
| `write_director_prompts` | 大導演劇場：擴寫或改寫圖片／影片的提示詞 | 否 |
| `generate_director_images` | 大導演劇場：每顆鏡頭生成一張圖 | **是** |
| `edit_director_image` | 大導演劇場：局部修改一張圖 | **是** |
| `generate_director_videos` | 大導演劇場：把每顆鏡頭的圖變成影片 | **是** |
| `wait_for_director_video` | 大導演劇場：等配音、圖片或影片做好並存到本機 | 否 |
| `get_previs_guide` | 走位排練室：讀場景資料的格式與寫法 | 否 |
| `stage_previs` | 走位排練室：排一場戲的走位、動作與運鏡，或修改 | 否 |
| `get_previs` | 走位排練室：查一個專案目前的場景、提示詞與匯出的影片 | 否 |
| `create_drama` | 短劇導演室：開一個短劇或短片專案，或修改設定 | 否 |
| `plan_drama_episode` | 短劇導演室：寫一集的大綱與要準備的人物、道具、場景 | 否 |
| `write_drama_script` | 短劇導演室：寫劇本、存改好的劇本，或做合理性檢查 | 否 |
| `get_drama` | 短劇導演室：查一個專案目前的內容與進度 | 否 |
| `edit_drama_assets` | 短劇導演室：增刪改人物／道具／場景、上傳照片、請平台寫設定卡 | 否 |
| `generate_drama_assets` | 短劇導演室：出人物定妝板與道具、場景的參考圖 | **是** |
| `plan_drama_segments` | 短劇導演室：把劇本分段，或調整段落 | 否 |
| `write_drama_prompts` | 短劇導演室：寫每一段的影片提示詞，或重寫、改寫 | 否 |
| `generate_drama_videos` | 短劇導演室：出片（一段一支影片） | **是** |
| `choose_drama_take` | 短劇導演室：同一段有多支影片時，指定採用哪一支 | 否 |
| `wait_for_drama` | 短劇導演室：等資產圖或影片做好並存到本機 | 否 |
| `create_comic` | 漫劇工作坊：開一部漫劇，或修改設定 | 否 |
| `get_comic` | 漫劇工作坊：看作品目前的設定、角色、分格與進度 | 否 |
| `research_comic` | 漫劇工作坊：查資料、修改、確認 | 否 |
| `edit_comic_cast` | 漫劇工作坊：增刪改角色／場景／道具、上傳照片或畫風參考圖 | 否 |
| `plan_comic_script` | 漫劇工作坊：寫劇本並分格（一頁九格） | 否 |
| `edit_comic_panels` | 漫劇工作坊：修改分格 | 否 |
| `generate_comic_images` | 漫劇工作坊：角色圖、九宮格、單格精修 | **是** |
| `generate_comic_videos` | 漫劇工作坊：出片（精修圖當第一幀，角色自己開口講話） | **是** |
| `choose_comic_take` | 漫劇工作坊：同一格有多支影片時，指定採用哪一支 | 否 |
| `wait_for_comic` | 漫劇工作坊：等圖或影片做好並存到本機 | 否 |
| `plan_song` | 音樂：開專案或更新歌曲設定與歌詞 | 否 |
| `write_song_lyrics` | 音樂：請平台作詞（回 2～3 個版本） | **是** |
| `generate_song` | 音樂：生成歌曲（一次兩首） | **是** |
| `wait_for_song` | 音樂：等做好並存到本機 | 否 |
| `create_vlog_series` | 網紅 VLOG：建立一個系列（一位固定的虛擬網紅） | 否 |
| `plan_vlog` | 網紅 VLOG：開一支影片並擴寫五段式提示詞 | 否 |
| `generate_vlog` | 網紅 VLOG：生成一整支影片 | **是** |
| `wait_for_vlog` | 網紅 VLOG：等做好並存到本機 | 否 |
| `plan_talking_video` | 真人配音影片：上傳人物照與口播稿，拆段並估點數 | 否 |
| `generate_talking_videos` | 真人配音影片：每段生成對嘴的講話影片 | **是** |
| `generate_broll_images` | 真人配音影片：B-roll 示意圖 | **是** |
| `generate_broll_videos` | 真人配音影片：把 B-roll 示意圖變成影片 | **是** |
| `wait_for_talking_video` | 真人配音影片：等做好並存到本機 | 否 |
| `list_voices` | 配音：列出可以選的聲音（內建聲音與自己上傳的） | 否 |
| `set_project_voice` | 配音：替專案選一個聲音 | 否 |
| `generate_voiceover` | 配音：用選好的聲音唸每一段（金句、知識影片、虛擬網紅、訪談影片、長片、真人配音） | **是** |
| `generate_lipsync` | 對嘴：把影片的嘴型對上配音（虛擬網紅、訪談影片） | **是** |
| `wait_for_voiceover` | 配音／對嘴：等做好並存到本機 | 否 |

-   每次生成前，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 不會主動做，你明講要它才會算點數給你確認；建議先做一段看效果。

## 環境變數

| 名稱 | 說明 |
| --- | --- |
| `AIVIDEOSPEED_API_KEY` | 必填，`avs_` 開頭 |
| `AIVIDEOSPEED_OUTPUT_DIR` | 選填，存檔的根目錄，預設是目前資料夾 |

## 金鑰安全

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

## 常见问题

### @aivideospeed/mcp 是什么？

aivideospeed MCP server：讓 Claude Code、Codex 直接用你的 aivideospeed 帳號生成圖片與影片，成品存進本機資料夾，網站的專案裡也看得到。

### 如何安装 @aivideospeed/mcp？

在项目目录运行 npm install @aivideospeed/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aivideospeed-mcp，可以用 npx aivideospeed-mcp 直接运行。

### @aivideospeed/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aivideospeed\_\_mcp 是否存在。

### @aivideospeed/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aivideospeed/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aivideospeed/mcp 可以商用吗？

@aivideospeed/mcp 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @aivideospeed/mcp 的下载量有多少？

根据 npm 官方下载统计，@aivideospeed/mcp 在 2026/10/05 – 2026/11/03 这 30 天内被下载 6,072 次，日均约 202 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aivideospeed/mcp 还在维护吗？

最新版本 0\.44\.0 发布于 2026/11/02（3 天前）；至今共发布 47 个版本，其中过去 12 个月发布了 47 个；首次发布于 2026/10/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。