将 CaptionBolt 接入你的工作流
从自己的应用或 AI 助手为已有视频添加字幕，在同一个 CaptionBolt 账户中检查并导出。
API、MCP 和 Webhooks 正在开发，尚未开放使用。以下文档用于预览首版接入方式，连接示例需要在服务和客户端包正式发布后使用。
选择接入方式
自己的应用或服务器自动化使用 REST API。需要让 AI 助手上传电脑上的视频时，选择本地 MCP；远程 MCP 用于操作已上传的项目。通过 Webhooks，在字幕准备好或成片导出后自动进入下一步。
这些文档介绍正在开发的首版集成。示例需要在接入开放后使用，不代表服务或 npm 包已经发布。
准备账户和密钥
开放后，登录 CaptionBolt，在设置 → 集成中为每个应用创建一把有名称的 API Key。明文只显示一次，请及时保存到应用的密钥管理器，不要放进对话、前端代码或源码仓库。
密钥默认 90 天过期，可选择 1–365 天或永不过期，也可以随时在设置中撤销。撤销会阻止新请求，已经接受的任务仍会继续；需要停止项目时，请明确执行取消。
只授予工作流需要的权限：
projects:read：读取账户限制、样式、预设、项目、操作状态和结果。projects:write：上传、创建项目、取消及重试。exports:write：导出、自动导出及导出重试。webhooks:manage：管理通知地址和投递记录，默认不勾选。
需要查询进度或下载结果时，请保留读取权限。
先检查，或直接自动导出
默认的 review 模式准备好字幕后停在待检查状态。你可以在 CaptionBolt 中校对和保存，再请求导出。明确选择 auto-export 后，完整处理结束会自动导出 MP4，不再等待人工检查。
API 和 MCP 共用现有账户的额度、套餐限制、水印和导出权限。首版接受 MP4、MOV、WebM、AVI，默认保留原画幅；其他已支持的视觉调整在主站编辑器中完成。首版不接受远程视频 URL，也不创建独立 Transcripts 项目。