登录

Cloud API

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

并随时调用准确片段。

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

POST /search200 · 82ms
{
  "request_id": "req_01k2cerul7c41ad",
  "usage": {
    "billable": true,
    "quantity": 1,
    "unit": "request"
  },
  "warnings": [],
  "data": [
    {
      "id": "ev_7c41ad",
      "video_id": "asset_2a91fc",
      "start_seconds": 768,
      "end_seconds": 794,
      "score": 0.82,
      "type": "speech",
      "text": "Scaling laws still hold if you look at loss, not benchmarks.",
      "related": [
        {
          "type": "screen_text",
          "start_seconds": 770,
          "end_seconds": 780,
          "text": "Loss vs. compute"
        }
      ],
      "context": {
        "before": [
          {
            "type": "speech",
            "start_seconds": 751.2,
            "end_seconds": 767.9,
            "text": "So what actually changed over the last year?"
          }
        ],
        "after": []
      },
      "thumbnail_url": "https://media.cerul.ai/v/asset_2a91fc/thumb.jpg?t=768&exp=1790334000&sig=3f9c",
      "playback": {
        "url": "https://media.cerul.ai/v/asset_2a91fc/web.mp4?exp=1790334000&sig=3f9c#t=768,794",
        "format": "mp4",
        "expires_at": "2026-09-25T10:00:00Z"
      },
      "console_url": "https://cerul.ai/console/videos/asset_2a91fc?t=768",
      "video": {
        "filename": "dwarkesh-dario-amodei.mp4",
        "duration_seconds": 8640,
        "summary": "A long-form interview on scaling, training data and AI safety.",
        "summary_generated": true
      }
    }
  ]
}

端点

POST
/videos

上传视频文件

GET
/videos/{video_id}

查询是否已可搜索

POST
/search

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

POST
/exports

把一段时间范围导出为 MP4 文件

完整契约见 OpenAPI 参考

完整流程,四个清晰步骤

上传、等待处理、检索片段、导出。每一步都有可追踪状态。

01

创建 Key

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

02

申请地址并直传

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

03

确认上传并等待

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

04

检索 / 导出

POST /search 取回片段,POST /exports 把时间范围导出为 MP4。

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

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