将 CaptionBolt 接入你的工作流

选择接入方式

CaptionBolt 集成可为已有视频添加字幕、查询项目进度并获取导出的成片。

| 你的目标 | 从这里开始 | 如何连接 | | --- | --- | --- | | 通过 AI 助手操作 CaptionBolt | MCP 配置指南 | 添加远程服务地址，再通过浏览器登录 | | 开发处理视频的应用或脚本 | REST API 指南 | 在 CaptionBolt 中创建 API Key | | 在项目就绪、导出完成或失败时通知应用 | Webhook 指南 | 配置应用的公共 HTTPS 接收地址 |

Webhooks 可配合 REST 和 MCP 使用。它们通知应用项目发生了变化，以便进入下一步。

开始之前

集成能力向 Max 订阅用户开放。请使用需要操作项目的账户登录 CaptionBolt。

通过集成处理视频时，使用账户现有的处理时长、视频限制和导出权限，没有独立的 API 时长额度。你可以通过 REST API 或 MCP 查询当前余额和限制。

在设置 → 集成中创建 API Key、管理 MCP 连接和配置 Webhooks。MCP 通过浏览器登录，无需 API Key。

处理你的视频

REST API 接受 MP4、MOV、WebM 和 AVI 文件上传，并可据此创建字幕项目。应用必须先上传文件，再创建项目；不能把远程视频 URL 作为上传输入。

远程 MCP 可查询和管理账户中的项目，包括在网站上创建的项目。它也可使用通过 REST 完成的上传创建项目，但不能上传你电脑中的文件。

项目默认保留原画幅。在 CaptionBolt 编辑器中检查字幕并进行已支持的视觉调整。这些集成用于视频字幕项目，不创建独立的 Transcripts 项目。

先检查或自动导出

根据任务选择工作流：

先检查： 默认使用 review。视频准备完成后停在 ready，请在编辑器中检查、保存修改，再导出。
自动导出： 创建项目时明确选择 auto-export，完整处理结束后自动导出 MP4，跳过等待检查的步骤。

导出使用最新保存的修改，不包含编辑器中的未保存内容。可通过 REST 或 MCP 下载已完成的导出。

开始配置

打开 MCP 配置指南、REST API 指南或 Webhook 指南，完成配置并进行首次验证。

完整的 REST 请求和响应结构见 API 参考 (将在新窗口中打开)或 OpenAPI 文档。

使用 MCP 时，打开 MCP 接入指南，复制安装指令，发送给能够配置客户端的 AI agent。接入 REST 或 Webhooks 时，在对应指南中点击复制给 AI 使用，并说明需要配置的应用。密钥使用占位符，真实密钥只在你自己的环境中输入。