登录

Cloud API

通过一个 API 理解视频、
保留上下文,

并随时调用准确片段。

Web 服务、CLI 与 agent 共用托管 REST 契约;上传、存储和云端执行始终显式。

POST /search200 · 82ms
{
  "request_id": "req_01k2cerul7c41ad",
  "execution": {
    "location": "cloud",
    "capability_id": "search",
    "capability_version": "1"
  },
  "usage": {
    "billable": true,
    "quantity": 1,
    "unit": "request"
  },
  "warnings": [],
  "data": [
    {
      "score": 0.93,
      "evidence": {
        "id": "ev_7c41ad",
        "asset_id": "asset_2a91fc",
        "kind": "transcript",
        "start_seconds": 768,
        "end_seconds": 794,
        "quote": "Scaling laws still hold if you look at loss, not benchmarks.",
        "locators": [
          {
            "type": "cloud",
            "url": "https://api.cerul.ai/artifacts/artifact_7c41ad"
          }
        ]
      }
    }
  ]
}

端点

POST
/videos

上传视频文件

GET
/videos/{video_id}

查询是否已可搜索

POST
/search

按语义检索,返回带时间码的 evidence

POST
/clips

从命中片段导出剪辑

完整契约见 OpenAPI 参考

完整流程,四个清晰步骤

上传、等待处理、检索证据、导出剪辑。每一步都有可追踪状态。

01

创建 Key

在 Console → API Keys 创建,保存本次显示的完整密钥。

02

申请地址并直传

请求直传地址,按返回的请求头 PUT 精确字节。

03

确认上传并等待

完成上传后开始记住,轮询直到 ready。

04

检索 / 剪辑

POST /search 取证据,POST /clips 导出片段。

文件上传是当前接入路径。URL 导入不在本次试用承诺内;标注能力需单独授权。示例输出不构成性能或质量保证。

从视频里,取回准确片段。