Spiral gives your agent every tool with one account. Browse the tools →

SpiralVideoAvailable now

HTML Video Renderer

render-video

Generate and edit video with HTML Video Renderer from Spiral through one Spiral API key. Renders an HTML and GSAP composition to an MP4 video: animated titles, slides, captions and motion graphics, up to 30 minutes. It runs in the background and returns video. Pay as you go, with no subscription.

Run time p50 · last 24 hours
2m 37s
Success rate · last 24 hours
98.0%

Pricing

$0.500001 for any video up to 10 minutes (durationInFrames / fps), then by the second up to $1.500002 at 30 minutes. Held and charged exactly; a refused composition is free.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
250 minutes
Longest run, end to end
455 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
code requiredtext—

The composition: one self-contained HTML document (<!DOCTYPE html><html>…</html>) with the root composition element and its paused GSAP timeline.

durationInFrames requirednumber (whole)
1 to 108000
—

The video's length in frames; durationInFrames / fps is its length in seconds, at most 1,800 (30 minutes), and must equal the root's data-duration.

fpsnumber (whole)
1 to 60
30

Frames per second.

widthnumber (whole)
100 to 3840
1920

Width in pixels; must equal the root's data-width.

heightnumber (whole)
100 to 2160
1080

Height in pixels; must equal the root's data-height.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "spiral",
    "model": "render-video",
    "input": {
      "code": "<code>",
      "durationInFrames": 1
    }
  }'

Frequently asked questions

How much does HTML Video Renderer cost?

$0.500001 for any video up to 10 minutes (`durationInFrames` / `fps`), then by the second up to $1.500002 at 30 minutes. Held and charged exactly; a refused composition is free. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use HTML Video Renderer through an API?

Send `POST /v1/runs` with `"provider": "spiral"`, `"model": "render-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Can my AI agent use HTML Video Renderer?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.