# Video & Timecode Calc

SMPTE timecode including drop-frame, shutter angle, slow motion, 2:3 pulldown, frame rates, resolution and bitrate maths.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://video-calc.x402tookit.com/openapi.json
- x402 manifest: https://video-calc.x402tookit.com/.well-known/x402
- Catalog (free): https://video-calc.x402tookit.com/catalog
- Health (free): https://video-calc.x402tookit.com/health
- Uptime (free): https://video-calc.x402tookit.com/uptime

## Endpoints (8)

### GET /frame-rate-info — $0.02
Exact fraction and frame duration of 23.976 to 60 fps, and the speed-up and runtime change when converting to another rate.
Params: fps: string, toFps?: string, runtimeMinutes?: number
Example: https://video-calc.x402tookit.com/frame-rate-info?fps=24&toFps=25&runtimeMinutes=100

### GET /pulldown-32 — $0.02
2:3 pulldown cadence: which film frames land in which video fields and frames when 24 fps film is telecined.
Params: filmFrames: integer, startPhase?: integer
Example: https://video-calc.x402tookit.com/pulldown-32?filmFrames=4

### GET /resolution-info — $0.02
Aspect ratio, megapixels, common name and uncompressed data rate for a video frame size, chroma subsampling and fps.
Params: width: integer, height: integer, fps?: number, bitDepth?: integer, chroma?: string
Example: https://video-calc.x402tookit.com/resolution-info?width=1920&height=1080&fps=24&bitDepth=8&chroma=420

### GET /shutter-angle — $0.02
Convert shutter angle to exposure time (and back) at a frame rate, plus the angle that avoids 50 or 60 Hz flicker.
Params: fps?: string, angle?: number, shutterDenominator?: number
Example: https://video-calc.x402tookit.com/shutter-angle?fps=24&angle=180

### GET /slow-motion — $0.02
Slow-motion factor from capture and playback fps, output duration for real seconds, and capture fps needed.
Params: captureFps: number, playbackFps?: number, realSeconds?: number, wantedSlowFactor?: number
Example: https://video-calc.x402tookit.com/slow-motion?captureFps=120&playbackFps=24&realSeconds=2

### GET /timecode-convert — $0.02
Convert frame counts to SMPTE timecode and back at 23.976 to 60 fps, with 29.97 and 59.94 drop-frame handled correctly.
Params: fps?: string, frames?: integer, timecode?: string, dropFrame?: string
Example: https://video-calc.x402tookit.com/timecode-convert?fps=29.97&frames=17982&dropFrame=true

### GET /timecode-math — $0.02
Add or subtract two SMPTE timecodes at a given frame rate, drop-frame aware, with the result in frames and seconds.
Params: a: string, b: string, op?: string, fps?: string, dropFrame?: string
Example: https://video-calc.x402tookit.com/timecode-math?a=01%3A00%3A00%3A00&b=00%3A00%3A30%3A12&op=add&fps=25

### GET /video-bitrate-size — $0.02
File size from video bitrate and duration (MB, GB, GiB), bits per pixel, or the bitrate that hits a target size.
Params: seconds: number, bitrateMbps?: number, targetSizeMB?: number, width?: integer, height?: integer, fps?: number, audioKbps?: number
Example: https://video-calc.x402tookit.com/video-bitrate-size?seconds=3600&bitrateMbps=10&width=1920&height=1080&fps=24

## Terms

Video and film arithmetic computed locally from the numbers given, per SMPTE and standard industry definitions, provided as is. Frame rates 23.976, 29.97 and 59.94 are the exact fractions 24000/1001, 30000/1001 and 60000/1001. Not a substitute for your editing system's own timecode handling in delivery-critical work.