使用AI智能体自动进行视频编辑
使用ClipReel REST API通过持久渲染作业自动完成产品演示、社交媒体剪辑、字幕和可审阅的编辑。
连接智能体连接到 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 中打开,将编辑器带回完整工作区中的私有项目。
客户端设置和工作流
托管作业使用您的ClipReel套餐。 按方案查看聊天编辑和视频额度。



