Create a key
Create one in Console → API Keys and save the secret shown once.
Cloud API
Use the hosted REST contract from Web services, CLI tools, and agents. Upload, storage, and cloud execution stay explicit.
{
"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"
}
]
}
}
]
}/videosUpload a video file
/videos/{video_id}Check whether it is searchable yet
/searchSearch by meaning; returns timestamped evidence
/clipsExport a clip from a moment
Upload, wait for processing, retrieve evidence, and export a clip. Track the state at each step.
Create one in Console → API Keys and save the secret shown once.
Request a direct upload and PUT the exact bytes with the returned headers.
Confirm the upload, then poll until the video is ready.
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.