[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [HTML Video Renderer](https://spiral.ai/integrations/notion/html-video-renderer)

# How to Use HTML Video Renderer in Notion

Use HTML Video Renderer for animated titles, slides, and motion graphics with planned timing. Give the agent exact copy and scene timings so it can build a GSAP composition around your message.

|  |  |
| --- | --- |
| Model | HTML Video Renderer |
| Available through | Spiral |
| Category | Video |
| Price | $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. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with HTML Video Renderer in Notion

- Every Friday, use HTML Video Renderer to make a 20-second recap from the approved weekly updates. Select four updates, give each five seconds, and preserve the same scene order each week.
- Each morning, use HTML Video Renderer to turn today's confirmed agenda into a 15-second title sequence. Show at most three agenda items, with five seconds per item.
- At the end of each month, use HTML Video Renderer to present three approved metrics in 18 seconds. Give each metric six seconds and keep its label visible throughout its scene.
- Every Monday, use HTML Video Renderer to create a 12-second reminder from the confirmed event schedule. Show the event name, date, and location in order, with four seconds for each.
- After each approved release announcement, use HTML Video Renderer to create a 15-second recap. Present three changes with equal timing and check that every line has enough reading time.

## How to set up HTML Video Renderer in Notion

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Notion this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

4. **Run HTML Video Renderer in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds HTML Video Renderer, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run HTML Video Renderer**: One request; the result comes back by polling or a webhook.

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

Then paste one of the prompts above: Notion finds HTML Video Renderer on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/notion

## HTML Video Renderer tools and prices

- [HTML Video Renderer](https://spiral.ai/tools/spiral/render-video) (Spiral): $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.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| fps | 1 to 60 | 30 | Frames per second. |
| width | 100 to 3840 | 1920 | Width in pixels; must equal the root's data-width. |
| height | 100 to 2160 | 1080 | Height in pixels; must equal the root's data-height. |

## What can you do with HTML Video Renderer in Notion?

Make recurring reports easier to scan by turning approved updates into a consistent sequence of slides. Keep scene timing fixed between runs and ask the agent to check text length before rendering.

### Release announcement

Present a release headline, three changes, and a closing message. Give each change its own timed scene.

### Weekly metric recap

Turn approved numbers into a sequence of labeled slides. Reveal each result separately and hold the final summary for reading.

### Event title sequence

Animate an event name, date, and session title with staggered text starts.

### Process explainer

Explain a process with one step per scene and precisely timed transitions between steps.

### Text announcement

Give a short announcement a headline, supporting detail, and closing instruction using restrained text motion.

### Training slides

Build a sequence of definitions, examples, and recap slides. Specify reading holds separately from transitions.

### Comparison presentation

Present two approaches with matching labels and reveal corresponding points at the same time.

## Overview

- [Spiral media tools](https://spiral.ai/providers/spiral)
- [All Notion guides](https://spiral.ai/integrations/notion)

## HTML Video Renderer in other agents

- [Amp](https://spiral.ai/integrations/amp/html-video-renderer)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/html-video-renderer)
- [Claude](https://spiral.ai/integrations/claude-desktop/html-video-renderer)
- [Claude Code](https://spiral.ai/integrations/claude-code/html-video-renderer)
- [Cline](https://spiral.ai/integrations/cline/html-video-renderer)
- [Codex](https://spiral.ai/integrations/codex/html-video-renderer)
- [Cursor](https://spiral.ai/integrations/cursor/html-video-renderer)
- [Devin](https://spiral.ai/integrations/devin/html-video-renderer)
- [dots](https://spiral.ai/integrations/dots/html-video-renderer)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/html-video-renderer)
- [Gemini](https://spiral.ai/integrations/gemini/html-video-renderer)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/html-video-renderer)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/html-video-renderer)
- [goose](https://spiral.ai/integrations/goose/html-video-renderer)
- [Grok](https://spiral.ai/integrations/grok/html-video-renderer)
- [Grok Build](https://spiral.ai/integrations/grok-build/html-video-renderer)
- [Hermes](https://spiral.ai/integrations/hermes/html-video-renderer)
- [Instinct](https://spiral.ai/integrations/instinct/html-video-renderer)
- [Manus](https://spiral.ai/integrations/manus/html-video-renderer)
- [Muse](https://spiral.ai/integrations/muse/html-video-renderer)
- [Muse Code](https://spiral.ai/integrations/muse-code/html-video-renderer)
- [n8n](https://spiral.ai/integrations/n8n/html-video-renderer)
- [OpenClaw](https://spiral.ai/integrations/openclaw/html-video-renderer)
- [opencode](https://spiral.ai/integrations/opencode/html-video-renderer)
- [Perplexity](https://spiral.ai/integrations/perplexity/html-video-renderer)
- [Raycast](https://spiral.ai/integrations/raycast/html-video-renderer)
- [VS Code](https://spiral.ai/integrations/vscode/html-video-renderer)
- [Windsurf](https://spiral.ai/integrations/windsurf/html-video-renderer)
- [Zapier](https://spiral.ai/integrations/zapier/html-video-renderer)

## More Notion guides

- [H3 Max Turbo Text to Video](https://spiral.ai/integrations/notion/h3-max-turbo-text-to-video)
- [Hailuo 02 Fast Image to Video](https://spiral.ai/integrations/notion/hailuo-02-fast-image-to-video)
- [H3 Max Turbo Reference to Video](https://spiral.ai/integrations/notion/h3-max-turbo-reference-to-video)
- [Hailuo 02 Pro Image to Video](https://spiral.ai/integrations/notion/hailuo-02-pro-image-to-video)
- [H3 Max Turbo Image to Video](https://spiral.ai/integrations/notion/h3-max-turbo-image-to-video)
- [Hailuo 02 Pro Text to Video](https://spiral.ai/integrations/notion/hailuo-02-pro-text-to-video)

## Questions about HTML Video Renderer in Notion

**Can Notion use HTML Video Renderer?**

Yes. Add Spiral to Notion as an MCP server, and Notion can find and run HTML Video Renderer like any built-in tool.

**How much does HTML Video Renderer cost in Notion?**

$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 from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.

**Do I need a Spiral account to use HTML Video Renderer in Notion?**

No. Spiral runs HTML Video Renderer on its own Spiral account. You sign in to Spiral once and never paste a key.

**How long does it take to set up HTML Video Renderer in Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while HTML Video Renderer runs?**

HTML Video Renderer runs in the background. Notion starts the run, checks on it and gives you the video when it's ready.

**What should I include in an HTML Video Renderer prompt?**

Specify the exact text, scene order, and when each scene should start and end. Ask for the animation to be organized on a GSAP timeline so timing changes are easier to manage.

**How do I make titles appear one after another?**

Ask for staggered text starts and give the gap in seconds. For example, request that each line begin 0.2 seconds after the previous line.

**How can I control the exact timing of a scene?**

Give absolute start times, such as a headline at zero seconds and a supporting line at two seconds. GSAP supports positioning animations at specific times on a timeline.

**How do I change the feel of the animation?**

Describe whether movement should stay at a constant speed, slow down as it finishes, or bounce. Ask the agent to choose easing explicitly rather than rely on the GSAP default.

**What should I check when previewing the composition?**

Inspect the opening, each transition, and the ending by seeking to their timestamps. GSAP seek() suppresses callbacks by default, so check any visuals that depend on callbacks especially carefully.

