Name: video-thumbnail
Price: 0.03 USDC
Availability: InStock

$ man video-thumbnail

agentutility / mediakit / video-thumbnail

PRICE / CALL

$0.03

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

CATEGORY

media

STATUS

● live

NAME

video-thumbnail — video thumbnail / video frame extractor

SYNOPSIS

POST https://x402.org/v1/video-thumbnail
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Video thumbnail / video frame extractor. First, middle, or last frame as JPG. fal.ai ffmpeg. Fast — no full transcode.

INPUT — request schema

property	type	description	req?
video_url	string	Public URL of a video file.	required
frame_type	string	'first' (default), 'middle', or 'last'. enum: first · middle · last	optional

OUTPUT — response shape

field	type	description
image_url	string	Hosted URL of the extracted JPG frame from the video.
width	number	Width of the extracted frame in pixels.
height	number	Height of the extracted frame in pixels.
file_size_bytes	number	Size of the returned JPG file in bytes.
content_type	string	MIME type of the extracted frame, typically image/jpeg.
frame_type	string	Which frame was extracted: first, middle, or last.
source_url	string	Original video URL that the frame was pulled from.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/video-thumbnail \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the video-thumbnail tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

ADJACENT — other endpoints in mediakit

endpoint	description	price
logo-detect	Brand logo detection / brand recognition in images.	$0.03
audio-loudnorm	Audio loudness normalizer (EBU R128 LUFS).	$0.02
csv-to-jsonl	CSV to JSON / CSV to JSONL converter / data pipeline preprocessor.	$0.02
image-translate	Image translator: vision-OCR + Venice translate.	$0.02
image-upscale	Image upscale / 2x upscaler / 4x upscaler / super-resolution / sharpen image / enlarge image without loss.	$0.02
pdf-watermark	PDF watermark / image watermark / video watermark — text or image overlay on PDFs, PNG/JPG/GIF, or MP4/MOV/WEBM.	$0.02
video-to-subtitles	SRT / VTT subtitle generator from video or audio.	$0.02
video-trim	Video trimmer / video cutter / video clip tool.	$0.02

/video-thumbnail(1)