Skip to content
ShapelessAI← Back
Media

Record a product demo

Show a product being used: a real Chromium opens your page and performs the steps you name (type into a field, click, hover, scroll, wait) and you get an MP4 of it drawn the way Screen Studio draws one, with a cursor that travels to each action and a camera that follows it.

View as Markdown

Good for a launch post or the middle of a short, where a screenshot cannot show the flow.

Ask in plain words

  • "record a demo of signing up on our site"
  • "make a screen recording of our pricing page flow"
  • "product demo video API"

From an agent host (MCP)

Server: https://shapelessai.com/mcp (add it to your host).

  • demo_page: A real browser opens a URL and performs the steps you name (type, click, hover, scroll, wait); returns an MP4 media key drawn like a screen-recorded demo, with a cursor and camera that follow each action. A page behind a login demos as its login wall. Free: nothing is charged. Needs the write scope.

From code (REST)

Bearer API key with the scope each call names (auth, OpenAPI).

  • POST /api/videos/demo (write scope): Record a product demo of a page (tool demo_page). Schema on GET /api/tools.

The body

  • url string, required: The absolute URL of the page to demo.
  • steps string, required: One step per line or semicolon: "type acme.com into the URL field; click Analyze; wait 2; hover the first result; scroll to Pricing". Add "for 2s" to hold a step longer.
  • name string, required: A 2-6 word filename for the clip, e.g. "analyze flow demo".
  • viewport string (mobile, desktop): Which screen to demo on. mobile by default for a 9:16 clip (the page fills the reel), desktop otherwise or when the reel shows the desktop product.
  • aspect string (9:16, 1:1, 16:9): The clip's shape. 9:16 by default so it fills a reel behind a cutout speaker.
  • zoom boolean: Ease the camera onto each element touched. On by default; off shows the whole page.
  • browser_bar boolean: Draw a browser bar with the address above the page. On by default.
  • budgetUsd number: The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.

From a terminal (CLI)

  • shapeless tools run demo_page --input '<json>' (tools show demo_page prints the schema)

Example

curl -s https://shapelessai.com/api/videos/demo -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"name":"signup demo","url":"https://example.com","steps":"click Get started; type founder@example.com into Email; click Continue"}'

Refusals

StatusMeaning
400The input does not match the tool's schema; the message names the field.
402Not enough credit to hold budgetUsd, or the call costs more than budgetUsd.
404No such tool on this deployment.
422The tool refused this input; nothing was charged.
502The tool failed; nothing was charged.

Where else

More in Media

Generate an image · Generate AI video · Edit a video · Render a carousel · Render a thumbnail · Turn text into speech · Make subtitle files · Call any agent tool

Every capability · Docs · /llms.txt