# BRAINIAC Evidence Intelligence — Video Keyframe Extractor

> BRAINIAC Evidence Intelligence — Video Keyframe Extractor is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-12).

Extracts keyframes from uploaded video files locally, inspecting container metadata and returning frame images with hashes, dimensions, and timestamps — without sending files to external AI or forensic services.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/evidence-intelligence/video-keyframe-extract?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-evidence-intelligence-video-keyframe-extractor-cbe7a3e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xyTHOsqAGGjyRMQr-PfZK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-evidence-intelligence-video-keyframe-extractor-cbe7a3e5 -d '<json body>'
```

Example prompt: Extract keyframes from this MP4 video I'm attaching — I need the frame images, their SHA-256 hashes, dimensions, and capture timestamps, all processed locally without sending the file to any external service.

## When to prefer this

Choose this endpoint when you need to extract keyframes from video files for evidentiary, forensic, or integrity-verification purposes where it is critical that files are NOT sent to external AI or forensic services. It is specifically designed for chain-of-custody workflows, legal evidence handling, or compliance scenarios requiring local-only processing with cryptographic hash verification. Prefer this over general video processing APIs when auditability, privacy, and verifiable non-disclosure to third parties are requirements.

## Known failure modes

- Invalid or corrupt video file base64 — returns error with no keyframes extracted
- Unsupported video container format — may return container inspection with empty keyframe array
- File size exceeds maxLength of 12,000,000 base64 characters — request rejected
- expectedSha256 mismatch — hash verification failure noted in findings
- Missing required fileBase64 field in files array — validation error
- files array exceeds 40 items limit — request rejected

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object containing an array of video items, each with extracted keyframes (id, filename, dimensions, SHA-256 hash, captured timestamp, file size), container metadata (format, major brand, top-level boxes), keyframe count, findings (observations about processing method), a checkedAt timestamp, and a detailed limitations section clarifying that no external AI or forensic services were used, no files were sent externally, and cryptographic hashes verify byte integrity only.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "label": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "parentId": {
      "type": "string",
      "maxLength": 80
     },
     "mediaType": {
      "enum": [
       "image/png",
       "image/jpeg",
       "image/webp",
       "image/gif",
       "video/mp4",
       "video/quicktime",
       "application/pdf",
       "application/octet-stream",
       "text/plain",
       "application/json"
      ],
      "type": "string"
     },
     "capturedAt": {
      "type": "string",
      "maxLength": 40
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     },
     "expectedSha256": {
      "type": "string",
      "maxLength": 128
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "custodyEvents": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
     },
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "note": {
      "type": "string",
      "maxLength": 500
     },
     "actor": {
      "type": "string",
      "maxLength": 200
     },
     "action": {
      "type": "string",
      "maxLength": 120
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "hashAfter": {
      "type": "string",
      "maxLength": 128
     },
     "evidenceId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 400
  },
  "expectedHashes": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "digest": {
      "type": "string",
      "maxLength": 128
     },
     "filename": {
      "type": "string",
      "maxLength": 180
     },
     "algorithm": {
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "videoId": "VID-1",
    "filename": "clip.mp4",
    "container": {
     "note": "MP4 boxes were inspected locally. Decoded video frames are not invented and no external transcoder was used.",
     "container": "mp4",
     "majorBrand": "mp42",
     "topLevelBoxes": [
      "ftyp"
     ]
    },
    "keyframes": [
     {
      "id": "KF-1",
      "size": 70,
      "width": 1,
      "height": 1,
      "sha256": "c414cd0e204de974f73753c7e28d7638e7b3691bb8b1a2bab6b25bb7fed7ce77",
      "filename": "frame-01.png",
      "capturedAt": "2026-10-01T12:00:01.000Z"
     }
    ],
    "mediaType": "video/mp4",
    "keyframeCount": 1,
    "externalAiUsed": false,
    "factualAuthenticityClaimed": false,
    "externalForensicServiceUsed": false
   }
  ],
  "status": "extracted",
  "findings": [
   {
    "code": "no_external_decode",
    "kind": "observation",
    "detail": "Video container metadata was inspected locally. Frames were not decoded by an external forensic or AI service.",
    "subject": "VID-1"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "videoCount": 1,
  "limitations": [
   "Evidence bytes are processed only in this local request path. Files are not sent to external AI or forensic services.",
   "Cryptographic hash matches verify byte integrity only. They do not prove factual authenticity of depicted events or authorship.",
   "C2PA checks look for local provenance markers and structure hints in the uploaded bytes. Marker presence is not a factual authenticity determination.",
   "Video keyframes are taken only from caller-supplied frame files or container metadata. Frames are not decoded by an external service and are not invented.",
   "Location clues come from embedded metadata or labeled caller fields. Missing GPS is not invented."
  ],
  "keyframeCount": 1,
  "apiKeyRequired": false,
  "externalAiUsed": false,
  "paidProviderUsed": false,
  "filesSentExternally": false,
  "factualAuthenticityClaimed": false,
  "externalForensicServiceUsed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-evidence-intelligence-video-keyframe-extractor-cbe7a3e5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
