# AgentRXI Video Thumbnail Extractor

> AgentRXI Video Thumbnail Extractor is a paid API for AI agents from agentrxi.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-15).

Extracts one or multiple still frames from a video URL, returning JPEG, PNG, or WebP images at a specified timestamp or evenly spaced across the video.

## Facts

- Endpoint: GET https://agentrxi.com/v1/media/thumbnail?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentrxi-video-thumbnail-extractor-640d8208
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ttIQtKHKerVKOArbR25V0

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 agentrxi-video-thumbnail-extractor-640d8208
```

Example prompt: Grab me 5 evenly spaced frames from this video as PNG images at 640px wide: https://example.com/clip.mp4 — I want them as a storyboard preview.

## When to prefer this

Use this endpoint when you need to extract still frames from an existing video (by URL or base64) rather than generating new images from scratch. It is ideal for creating thumbnails, storyboards, or poster frames at controlled timestamps without needing a full video processing pipeline. Choose it over general-purpose vision APIs when you specifically need frame capture with format and resolution control.

## Known failure modes

- Video URL not reachable or exceeds 20 MB limit — request fails
- Invalid timestamp format (not seconds or hh:mm:ss) causes parse error
- Unsupported video format may result in extraction failure
- count outside 1-10 range returns validation error
- Width outside 64-1920 px range is rejected
- base64 payload too large may exceed request limits

## How this service works

Grab still frames from a video: one frame at a given time, or up to 10 evenly spaced frames for a storyboard. JPEG, PNG or WebP, width 64-1920 px. Also callable as GET with the same fields as query parameters.

## Output

Returns one or more still frames extracted from the video as base64-encoded images (JPEG, PNG, or WebP) at the requested width. If the output exceeds 3 MB or the store flag is set, returns 7-day hosted share links instead of raw base64. For a single frame with format=binary, returns raw file bytes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "at": {
       "type": "string",
       "description": "Time of the frame (seconds or hh:mm:ss), default 1 s"
      },
      "url": {
       "type": "string",
       "description": "https URL of the file (max 20 MB)"
      },
      "count": {
       "type": "integer",
       "description": "1-10 evenly spaced frames"
      },
      "store": {
       "type": "boolean",
       "description": "Return 7-day share links instead of base64 (+$0.001); automatic above 3 MB"
      },
      "width": {
       "type": "integer",
       "description": "Default 640"
      },
      "format": {
       "type": "string",
       "description": "binary = raw file bytes (single output)"
      },
      "filename": {
       "type": "string",
       "description": "Name with extension, helps detect the type"
      },
      "file_base64": {
       "type": "string",
       "description": "Or the file as base64 / data URI"
      },
      "image_format": {
       "type": "string",
       "description": "jpg (default), png, webp"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentrxi-video-thumbnail-extractor-640d8208/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentrxi.com](https://www.zero.xyz/host/agentrxi.com/llms.txt)