Log in

Cloud API

One API to understand video, retain context, and retrieve the right moment on demand.

Use the hosted REST contract from Web services, CLI tools, and agents. Upload, storage, and cloud execution stay explicit.

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"
          }
        ]
      }
    }
  ]
}

Endpoints

POST
/videos

Upload a video file

GET
/videos/{video_id}

Check whether it is searchable yet

POST
/search

Search by meaning; returns timestamped evidence

POST
/clips

Export a clip from a moment

Full contract in the OpenAPI reference

A complete flow in four steps

Upload, wait for processing, retrieve evidence, and export a clip. Track the state at each step.

01

Create a key

Create one in Console → API Keys and save the secret shown once.

02

Request an upload

Request a direct upload and PUT the exact bytes with the returned headers.

03

Complete and wait

Confirm the upload, then poll until the video is ready.

04

Search / clip

POST /search for evidence, POST /clips to export the moment.

File upload is the current integration path. URL import is not included in this trial; annotation requires its own scope. Example output is not a performance or quality guarantee.

Find the right moment, inside your video.