# RelayStation Video Frame Thumbnail Extractor

> RelayStation Video Frame Thumbnail Extractor is a paid API for AI agents from api.relaystation.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Extracts a single video frame as a PNG or JPEG image from any video at a specified timestamp

## Facts

- Endpoint: POST https://api.relaystation.ai/v1/media/thumbnail
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/relaystation-video-frame-thumbnail-extractor-c82325da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8kONqpPInF1bplG4NIBoH

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 relaystation-video-frame-thumbnail-extractor-c82325da -d '<json body>'
```

Example prompt: Grab the video frame at the 1 minute 30 second mark from this video URL https://example.com/video.mp4 and give it back to me as a JPEG thumbnail.

## When to prefer this

Choose this endpoint when you need to extract a single still frame from a video at a precise timestamp and receive it as a standard image format (PNG or JPEG). It is ideal for generating thumbnails, poster images, scene captures, or preview stills from video content without downloading or processing the entire video file. It is not suited for transcribing video audio, analyzing video content, or generating multiple frames in bulk.

## Known failure modes

- Invalid or inaccessible video URL returns an error
- Timestamp beyond video duration returns an out-of-bounds error
- Unsupported video format may cause extraction failure
- Network timeout if the video source is slow to respond
- Invalid output format specification returns a validation error

## How this service works

$0.0003/call. Grab a single video frame at any timestamp — PNG or JPEG out. 1¢ x402 min; remainder auto-credits — relaystation.ai/penny

## Output

A single image file (PNG or JPEG) representing the exact video frame at the requested timestamp, returned as binary image data or a base64-encoded image.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "file": {
       "type": "object",
       "description": "cputools input-source: { inline: <base64 ≤ 4 MiB> } or { inputKey: <scratch key ≤ 50 MB> }. The input container must sniff (ffprobe) to the live allowlist (operator-tunable cputools.media.input_formats): 3g2, 3gp, aac, asf, avi, flac, flv, gif, m4a, m4v, matroska, mj2, mov, mov,mp4,m4a,3gp,3g2,mj2, mp3, mp4, mpeg, mpegts, mpegvideo, ogg, wav, webm, wmv. An off-list input is a free 422 UNSUPPORTED_FORMAT."
      },
      "timestamp": {
       "type": "number",
       "minimum": 0
      },
      "format": {
       "type": "string",
       "enum": [
        "png",
        "jpeg",
        "jpg"
       ]
      }
     }
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/relaystation-video-frame-thumbnail-extractor-c82325da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relaystation.ai](https://www.zero.xyz/host/api.relaystation.ai/llms.txt)