How to Use HeyGen Video Agent v2 in Raycast
HeyGen Video Agent v2 turns a written brief into a narrated video for explainers, lessons, and product announcements. Give it a complete script and scene directions when the wording and visual sequence matter.
Prompts to try with HeyGen Video Agent v2 in Raycast
Copy an example into Raycast, or ask in your own words.
Use HeyGen Video Agent v2 to create a roughly 30-second lesson explaining compound interest to beginners. Use a hypothetical example, label it clearly, and keep the visual style consistent.
Use HeyGen Video Agent v2 to make a roughly 60-second lesson on active listening for new managers. Include an example conversation, three practical habits, and a closing recap.
Create a roughly 30-second product announcement with HeyGen Video Agent v2. The product is a reusable lunch container with removable dividers. Address commuters, explain that feature, and end by inviting viewers to learn more.
Use HeyGen Video Agent v2 to make a roughly 60-second how-to video about preparing for a job interview. Write four scenes with narration and supporting visuals in one consistent style.
Use HeyGen Video Agent v2 to create a roughly 90-second lesson explaining the water cycle to middle school students. Show evaporation, condensation, and precipitation with narrated motion graphics.
How to set up HeyGen Video Agent v2 in Raycast
Pick the way that suits you. Each takes about two minutes.
Use the Raycast connector
- Install the server
In Raycast run Install MCP Server. Name it Spiral, set Transport to HTTP, paste this URL and keep OAuth Type on Dynamic:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Spiral opens in your browser: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Raycast never sees it, and you can remove it under Settings › Connected apps in the console.
Use the Spiral skill
- Send Raycast this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run HeyGen Video Agent v2
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "fal", "model": "fal-ai/heygen/v2/video-agent", "input": { "prompt": "Create a 15-second explainer video about fal.ai Video Workflows.\n Target audience: Developers, AI engineers, and creative tech teams\n …" } }'
Then paste one of the prompts above: Raycast finds HeyGen Video Agent v2 on Spiral, shows the price and runs it.
HeyGen Video Agent v2 providers and prices
Spiral runs HeyGen Video Agent v2 through fal. Open a card for today's price, with every fee included.
config.duration off adds $13.26 per run. config.duration adds $3.978 per minute. Billed on config.duration.
What can you do with HeyGen Video Agent v2 in Raycast?
Turn an idea or written explanation into a narrated lesson or announcement. Use the conversation to settle the audience, required facts, and scene sequence before creating the video.
Customer onboarding explainers
Explain one product concept with narration and a short sequence of supporting visuals.
How-to videos
Turn a written procedure into a narrated sequence with one clear instruction per scene.
Course lessons
Teach one concept, walk through an example, and finish with a recap.
Employee training
Explain a policy through a practical scenario and a short checklist.
Product announcements
Introduce a change, explain who it helps, and describe the next action.
Sales outreach
Build a short narrated introduction around a prospect's problem and a relevant product benefit.
Company news briefs
Summarize approved announcements with names, dates, and next steps supplied in the brief.
More on HeyGen Video Agent v2 and Raycast
Overview
HeyGen Video Agent v2 in other agents
Questions about HeyGen Video Agent v2 in Raycast
Can Raycast use HeyGen Video Agent v2?
Yes. Add Spiral to Raycast as an MCP server, and Raycast can find and run HeyGen Video Agent v2 like any built-in tool.
How much does HeyGen Video Agent v2 cost in Raycast?
`config.duration` off adds $13.26 per run. `config.duration` adds $3.978 per minute. Billed on `config.duration`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Raycast plan is separate.
Do I need a fal account to use HeyGen Video Agent v2 in Raycast?
No. Spiral runs HeyGen Video Agent v2 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up HeyGen Video Agent v2 in Raycast?
About two minutes: install the server, then sign in to Spiral and approve.
Does Raycast wait while HeyGen Video Agent v2 runs?
HeyGen Video Agent v2 runs in the background. Raycast starts the run, checks on it and gives you the video when it's ready.
What is HeyGen Video Agent good for?
Use it for narrated explainers, how-to videos, course lessons, training, product demonstrations, and sales outreach. HeyGen also lists news briefs and company updates.
How long can a HeyGen Video Agent v2 video be?
The documented minimum is five seconds, with suggested lengths of 30, 60, or 90 seconds. Duration is approximate, and those suggestions do not establish a maximum.
Can I supply a complete script?
Yes. HeyGen recommends pasting a full script to guide the scene sequence, while Video Agent adjusts flow, timing, and visuals.
What should I include in the brief?
Identify the audience and list the facts, names, numbers, and steps that must appear. That gives Video Agent concrete requirements to work from.
How do I keep scenes visually consistent?
Define a visual style before generation and carry it through the scene instructions. HeyGen warns that unspecified styling can lead to scenes that look inconsistent.
Start using HeyGen Video Agent v2 in Raycast
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Raycast:
set up https://spiral.ai/SKILL.md


