Skip to content
HTML/CSS to ImageDocs

Recordings: HTML and URLs to Video and GIF

Copy page

You can now turn HTML/CSS or any URL into a video or GIF. Send the same HTML or URL you’d use for an image, choose how long to record, and get back a recording_url you can embed in your app, website, or email, or request directly.

{
"url": "https://example.com",
"duration_ms": 6000,
"output": { "format": "mp4" },
"actions": [{ "type": "simple_scroll" }]
}
  • MP4, WebM, and GIF output. Set the format, frame rate, and scale with output.
  • Actions. Scroll, click, pause, and run JavaScript during the recording with optional actions, with easing for smooth movement.
  • Start at the right moment. Use a trigger to wait for an element to appear or for your page to call window.RecordingReady(), so loading spinners stay out of the video.
  • Flexible length. Record for a fixed time, or let duration_mode fit the video to your actions.
  • Works with what you already use. Recordings support viewport settings, proxies, cookie banner blocking, storage destinations, and the dl download parameter.
  • Manage and automate. List, retrieve, store, and delete recordings with the Management API. You can optionally check a recording’s status for workflows, and subscribe to recording_stored, recording_failed, and recording_deleted webhook events.
  • MCP tools. Agents can create and manage recordings with the new recording tools.

Recordings are available on the Startup plan (10,000 images/month) and higher. A recording uses 2 credits for its first 5 seconds and 1 credit for each additional 5 seconds. See Credits for how duration modes affect usage, with worked examples.

Get started with the Recordings overview, or follow a guide for scrolling videos, animated HTML, or interactions.

All updates