record_video
Record professional demo videos of browser automation sequences with cursor highlighting, step annotations, and customizable visual effects.
Instructions
Record a professional demo video of a multi-step browser automation sequence. Produces MP4/WebM/GIF with cursor highlighting, click effects, smooth movement, step notes, browser frame (macOS/Windows), gradient/glass backgrounds, and more. Costs 3 API requests. Saves to disk. BEST PRACTICE: Keep videos concise (5-15 action steps). Do NOT add wait steps between every action — the pace parameter handles timing. Only use wait for page loads or narration holds. Do NOT use zoom unless the user explicitly asks for it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| steps | Yes | Array of action steps to record. Keep concise: 5-15 steps is ideal. Do NOT pad with wait steps — pace handles timing. | |
| viewport | No | Browser viewport size | |
| format | No | Video format (default: mp4). webm/gif require Starter+ plan. | |
| framerate | No | Frames per second: 24, 30, or 60 (default: 30) | |
| cursor | No | Cursor appearance settings | |
| zoom | No | Global zoom settings. Only use when the user explicitly requests zoom. Do NOT enable by default. | |
| autoZoom | No | Enable auto-zoom on all clicks (default: false). Only use when user explicitly requests zoom. | |
| clickEffect | No | Visual click effect settings | |
| pace | No | Controls how deliberate the video feels. Number (0.25–6.0, higher = slower) or preset: "fast" (0.5×), "normal" (1×), "slow" (2×), "dramatic" (3×), "cinematic" (4.5×). Default: "normal". | |
| frame | No | Browser chrome frame around the video. Adds a macOS/Windows-style title bar. | |
| background | No | Styled background behind the video. Adds gradient/solid background with padding and rounded corners — creates a "floating window" effect. | |
| darkMode | No | Emulate dark color scheme (default: false) | |
| blockBanners | No | Hide cookie consent banners (default: true for videos) | |
| blockAds | No | Block advertisements on the page | |
| blockChats | No | Block live chat widgets | |
| blockTrackers | No | Block tracking scripts | |
| deviceScaleFactor | No | Device pixel ratio (default: 1) | |
| audioGuide | No | Audio Guide TTS settings. Two modes: (1) Per-step — add "narration" to individual steps. (2) Script — provide "script" with {{N}} markers for continuous narration synchronized to steps. | |
| variables | No | Key-value map for variable substitution in step URLs/values. E.g. { "base_url": "https://example.com" } replaces {{base_url}} in steps. | |
| saveTo | No | Output file path (default: ./recording.mp4) |