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