登入

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

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