适用于智能体的ClipReel

使用AI智能体自动进行视频编辑

使用ClipReel REST API通过持久渲染作业自动完成产品演示、社交媒体剪辑、字幕和可审阅的编辑。

连接智能体

在真实素材上尝试编辑

比较八秒的原始镜头和六秒的剪辑。打开示例项目,准备好发送请求。

剪掉前两秒,添加标题“山脊上的一天”持续三秒,调冷色调,并在最后半秒淡出。
在ClipReel中尝试 下载原始剪辑
原始镜头
剪辑、标题和淡出

连接到 ClipReel

创建一个作用域令牌,将其保存为 CLIPREEL_API_TOKEN,并配置您的客户端。请使用项目读取、项目写入和作业令牌进行操作指南演示。

curl https://www.clipreel.com/api/v1/projects \
  -H "Authorization: Bearer $CLIPREEL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product walkthrough"}'

分阶段自动化产品演示

为每次发布创建一个项目并导入原始录屏。通过明确的开场、目标时长和字幕要求来排队 edit_by_prompt。为每个任务提交一个幂等键,以便重试时能恢复原始结果。

从已批准的剪辑中制作社交媒体版本

在每个 export_video 请求中固定相同的已保存版本,并为 16:9、9:16 或方形版本发送不同的键。轮询任务资源以获取最新状态。使用编辑链接打开相同的素材、剪辑、字幕和特效,然后再请求导出。

在集成中处理错误和权限

使用范围受限的账户令牌并直接上传至签名 URL。在读取完成状态前,根据原始请求体验证回调签名。使用稳定的任务 ID 来处理重试。对于合作伙伴应用,为其确切的来源和项目创建一个范围受限的嵌入会话。

REST 工作流程

发送 JSON 格式,其中包含 Authorization: Bearer $CLIPREEL_API_TOKEN。对于文件导入,将声明的文件名、媒体类型、字节长度和时长发送至 POST /tools/import_media。使用相同的内容类型和长度将文件上传到返回的 URL。

起草发布剪辑

POST https://www.clipreel.com/api/v1/tools/edit_by_prompt
{
  "projectId": "PROJECT_ID",
  "prompt": "Remove pauses, add captions, and cut a 45-second launch video",
  "idempotencyKey": "launch-v1-edit"
}

生成或导入字幕提示

排队 POST /tools/transcribe_video 使用项目 ID。然后轮询 GET /jobs/JOB_ID。传递返回的 result.cues to POST /tools/add_captions 以及诸如 white or lime之类的样式。为您自己提供的时间戳使用相同的提示对象。

导出竖屏剪辑

POST https://www.clipreel.com/api/v1/tools/export_video
{
  "projectId": "PROJECT_ID", "revision": 7,
  "aspect": "9:16", "resolution": "720p",
  "idempotencyKey": "launch-v1-vertical", "webhookId": "WEBHOOK_ID"
}

验证签名回调

在 POST /webhooks 注册您的 HTTPS 端点,并使用 {"url":"https://partner.example.com/clipreel"}。存储返回的签名密钥。对 Unix 时间戳、句点和原始请求体计算 HMAC-SHA256。将其与 v1 标头中的 ClipReel-Signature 进行恒定时间比较。拒绝超过五分钟的时间戳。将 ClipReel-Delivery 视为去重 ID。轮询获取最新的已签名媒体链接。

嵌入相同的可编辑项目

POST https://www.clipreel.com/api/v1/embed-sessions
{
  "projectId": "PROJECT_ID",
  "origin": "https://partner.example.com",
  "permission": "edit"
}

在注册来源的 iframe 中加载 embedUrl 。会话持续 20 分钟并继承令牌权限。为仅供查看的会话设置 permission to view 。在 ClipReel 中打开,将编辑器带回完整工作区中的私有项目。

客户端设置和工作流

在Claude Code中进行视频编辑

要求Claude Code将录制内容转化为可编辑的剪辑。审阅预览,然后在ClipReel中打开同一个项目。

Claude Code 设置
剪掉前两秒。

视频编辑MCP服务器

将MCP客户端连接到ClipReel以创建项目、提出时间线编辑建议、审阅预览并导出可编辑的剪辑。

MCP 设置

从Cursor编辑产品视频

使用Cursor和ClipReel将产品演示录制内容转化为带有字幕和多种导出格式的可编辑视频。

Cursor 工作流

使用AI智能体自动进行视频编辑

使用ClipReel REST API通过持久渲染作业自动完成产品演示、社交媒体剪辑、字幕和可审阅的编辑。

REST API 指南

托管作业使用您的ClipReel套餐。 按方案查看聊天编辑和视频额度。