The short version
以一個公開 URL、5 個真實 MCP 工具、30 秒 brief 和一次如實記錄的生產測試完成實作。
Claude 可以協調動態圖形影片工作流程，但不會自己算圖。我把 Claude 連接到 TapVid MCP，以公開 API 和 MCP 頁面作為素材，要求產生 30 秒、16:9 的英文解說影片。重點是工具順序、非同步狀態與人工驗收邊界。
Review TapVid API and MCP access
01
Claude 負責協調，TapVid 負責算圖
这里的“Claude video generation”不代表 Claude 亲自绘制帧、制作动画并导出 MP4。Claude 理解目标、调用结构化工具并观察结果，TapVid 处理素材、组织场景并渲染，MCP 是两者之间的連接层。分清边界，才能判断问题来自 brief、參數、渲染还是内容审核。
TapVid 把文章、文档、脚本、PDF、PRD 或产品页等现有内容转成结构化的信息影片。素材提供事实，prompt 提供受众和约束。事实、版权、节奏和最终發布仍由人负责。需要修正时，可以只重新生成一个场景并保留其余内容。
下面嵌入的是 Motion 提供的外部 Motion MCP 參考影片，不是本次 TapVid 實測成片。TapVid 的已驗證證據見後續截圖與時間記錄。
02
用 Bearer API Key 連接 Claude
当前官网說明中，REST 和 MCP 使用同一枚 Bearer API Key。在 API Keys 建立并安全保存，然后把 Claude 連接到 https://mcp.tapvid.ai/mcp。先调用 `get_account`，确认連接和额度后再花 credits。
- 在 `/developer/apikey` 建立金鑰并存入安全环境。
- 在 Claude 添加 `https://mcp.tapvid.ai/mcp` 和 Bearer header。
- 先用 `get_account` 檢查连接和 credits。
- 用 `upload_material` 上傳已批准的 HTTPS URL。
- 建立前明确时长、画幅、语言、受众和禁止项。
03
本次實測使用的 MCP 工具
本次计时的建立与导出流程使用了 5 个工具。当前連接器还提供 `edit_video`，但这个第 6 个工具没有纳入本次计时测试。
| 工具 | 作用 | 边界 |
|---|---|---|
| `get_account` | 檢查连接 | 隐藏電子郵件 |
| `upload_material` | 接收 URL | 私有 material ID |
| `create_video` | 建立任务 | 私有 video ID |
| `get_video_status` | 查詢状态 | 遵守轮询间隔 |
| `get_video_download` | 准备导出 | 限时签名 URL |
| `edit_video` | 编辑已完成视频 | 本次计时测试未调用 |
这次 brief 明确了 30 秒、16:9、英文、开发者受众，以 TapVid 頁面为事实來源，解释素材上传、异步生成和下载，并禁止编造性能、客户结果或未支持功能。
04
真實 30 秒測試發生了什麼
2026 年 8 月 7 日实测中，URL 上传约 0.4 秒，`create_video` 约 0.3 秒。任務约在 60 秒时进入 running 50%，保持超过 18 分钟，并在约 28 分 20 秒后 completed。第一次导出请求在 36 秒内仍是 recording，稍后复查才返回签名 URL。帳戶用量增加 90 credits。
这說明进度百分比不是线性倒计时。客户端必须尊重 `pollAfterSeconds`、保存 video ID、设置整体超时并向用户报告最后狀態。只有 completed 后才能请求下载。
05
如何排查 Claude 與 TapVid MCP
第一次账号查询还遇到过一次临时 transport error。網路、鉴权、參數、额度和长时间任務需要不同处理。只对临时读取失败做有限退避重试。
| 现象 | 层级 | 安全操作 |
|---|---|---|
| 網路错误 | 连接 | 只有限重试读取 |
| 401 | 密钥 | 檢查 secret |
| 400 | 參數 | 修正字段 |
| credits 不足 | 账户 | 停止并确认 |
| 50% 长时间不变 | 异步任務 | 保存 ID、遵守间隔和超时 |
没有收到响应不等于 create 失败。如果服务端已经受理，再建立一次会重复消耗。应用必须在下一次網路操作前持久化 material ID 和 video ID。
06
發布前檢查產生的影片
生成完成也只是草稿。要逐项核对來源、场景顺序、实际时长、字幕、画幅、音乐、版权和 CTA。Claude 可以帮助执行檢查，但不能承担事实和發布责任。
- 每个事实都能回到素材。
- 場景顺序符合流程。
- 時長接近 brief。
- 16:9 下文字可读。
- 版權和品牌已核对。
- 最终發布由人批准。
07
對話探索用 MCP，生產程式用 REST
MCP 更适合边聊边探索，REST 更适合持久狀態、重试、指标、队列和定时任務。两者的区别不是底层生成，而是谁拥有编排控制。
| 需求 | MCP | REST |
|---|---|---|
| 探索 prompt | 很适合 | 较手动 |
| 交互诊断 | 很适合 | 需自建 UI |
| 持久狀態 | 依赖会话 | 應用程式持有 |
| 重试和指标 | 依赖客户端 | 可编程 |
| 批次任务 | 非默认 | 很适合 |
实际做法可以是用 MCP 验证 prompt 和验收标准，再把重复任務迁移到 REST。不要因为 MCP 更新潮而选它，要看对话还是确定性更能减少工作。
08
保護金鑰並控制付費操作
API Key 能消耗 credits 并访问帳戶资源。不要放进 prompt、截图、Issue 或仓库。把读取、生成和發布权限分开，并参考 MCP 安全指南。
- 金鑰放入 secret store。
- 不公开金鑰、電子郵件、ID 和签名 URL。
- 把读取和付费写操作分开。
- 立即保存已受理任務 ID。
- 限制重试并确认重复写入。
- 只記錄状态和错误码，不記錄 header。
09
從一份素材與一個可衡量目標開始
第一次实验只用一份已批准頁面、一个受众、一条信息、16:9 和 30 秒。让 Claude 先說明工具顺序，記錄狀態和 credits，再按素材忠实度验收。可以从 TapVid API 和 MCP 概览开始。
10
常見問題
Claude 能自己生成影片吗？
Claude 負責规划和调用工具，TapVid 負責处理和渲染。
这次實際有哪些工具？
当前连接器提供 get_account、upload_material、create_video、get_video_status、get_video_download 和 edit_video。本次计时测试使用了前 5 个。
使用 OAuth 吗？
本次官网说明和实测使用 Bearer API Key。實作前应再次核对实时文档。
为什么要轮询？
生成是异步任務。应遵守 pollAfterSeconds，直到终态或明确超时。
什么时候用 REST？
需要持久状态、定时任務、可控重试和指标时使用 REST。
Kenneth Chen 邀請你加入 Discord，與其他影片創作者一起交流。
在 Discord 加入 KennethTurn them into a clear, publishable video
Keep reading
Related stories
Claude 影片生成：選 Seedance 2.5 還是 TapVid？
Claude 本身不能渲染影片。本文結合真實測試與可複用提示詞，說明何時該搭配 Seedance 2.5，何時該用 TapVid。
Aug 8, 2026
Text-to-Video API 教學：10 分鐘完成串接
約 10 分鐘寫完 REST 串接，再把算圖當作需要持久狀態的非同步任務處理。
Aug 7, 2026
什麼是說明影片？類型、用途與製作方法
什麼是說明影片？一種快速講清楚產品或想法的短影片。了解它的類型、各自的適用時機，以及如何製作一支。
Jul 17, 2026