HTML Video Renderer
render-videoGenerate 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.
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
| Field | Kind | Default | Description |
|---|---|---|---|
code required | text | — | The composition: one self-contained HTML document (<!DOCTYPE html><html>…</html>) with the root composition element and its paused GSAP timeline. |
durationInFrames required | number (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. |
fps | number (whole) 1 to 60 | 30 | Frames per second. |
width | number (whole) 100 to 3840 | 1920 | Width in pixels; must equal the root's data-width. |
height | number (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.