# HTML Video Renderer

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.

- Provider: Spiral
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `spiral` / `render-video`
- Page: https://spiral.ai/tools/spiral/render-video

## 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

- 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 | Allowed | 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. |

## Example

```bash
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
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=spiral&model=render-video

## Common questions

### HTML Video Renderer

**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.

