登入

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 匯入不在本次試用承諾內;標註能力需另外授權。範例輸出不構成效能或品質保證。

從影片裡,取回準確片段。