How to Use HeyGen Avatar IV in Cursor
HeyGen Avatar IV turns a single photo into a speaking presenter for explainers, training, and updates. Its audio-driven expressions also suit illustrated and 3D characters with clearly readable faces.
Prompts to try with HeyGen Avatar IV in Cursor
Copy an example into Cursor, or ask in your own words.
Use HeyGen Avatar IV with the presenter portrait in this project to explain the latest changelog entry. Write about 60 spoken words covering the change and its practical benefit, then generate a video with restrained movement.
Read this project's onboarding documentation and use HeyGen Avatar IV with its presenter image to make a welcome video. Explain the product's purpose and one first action in about 50 words.
Use HeyGen Avatar IV and the project's instructor portrait to introduce the authentication guide. Base the script on the documentation, keep it under 70 words, and use punctuation that gives the explanation natural pauses.
Find one recurring question in the project's support documentation. Use HeyGen Avatar IV with the support presenter image to deliver a direct answer in about 60 words, with a calm expression and minimal movement.
Use HeyGen Avatar IV with the project's illustrated guide image to introduce its tutorial. Check that the character has clear eyes and lips, write a 40-word introduction, and choose expressive movement.
How to set up HeyGen Avatar IV in Cursor
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to Cursor on the console's Agents & MCP page, or add this to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.
Use the Spiral skill
- Send Cursor 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 Avatar IV
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/avatar4/image-to-video", "input": { "image_url": "https://v3b.fal.media/files/b/0a90062c/A7EIviZqNxZ2HAs0yHeZ6_77a05b99-8588-4ffc-90aa-be7f9d34e9d3.png" } }'
Then paste one of the prompts above: Cursor finds HeyGen Avatar IV on Spiral, shows the price and runs it.
HeyGen Avatar IV providers and prices
Spiral runs HeyGen Avatar IV through fal. Open a card for today's price, with every fee included.
$0.13 per second of output video. The video is as long as the audio, or the spoken script when there is none.
Settings you can ask for
HeyGen Avatar IV works from your image URL, prompt, and audio URL. Ask Cursor for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Voice | Warm Pro Narrator, Chill Brian, Ivy, John Doe, Monika Sogam, Hope , Archer , Brittney and 94 more | Name of the voice to use for the avatar | |
| Talking style | stable or expressive | stable | Talking style - 'stable' for minimal movement, 'expressive' for more animation |
| Resolution | 360p, 480p, 540p, 720p, or 1080p | 720p | Video resolution preset. Options: 360p, 480p, 540p, 720p, 1080p |
| Aspect ratio | 16:9, 9:16, 4:5, 5:4, 1:1, or auto | 16:9 | Aspect ratio of the output video. Supported values: '16:9', '9:16', '4:5', '5:4', '1:1', and 'auto'. 'auto' preserves the source aspect ratio when HeyGen can read it, falling back to '16:9' otherwise. |
| Caption | on or off | off | Whether to add captions to the video |
Every API field of HeyGen Avatar IV Photo to Video is on its tool page: open its card above.
What can you do with HeyGen Avatar IV in Cursor?
Turn project documentation into presenter videos for releases, onboarding, and support with HeyGen Avatar IV. A coding agent can extract the relevant details, draft spoken copy, and pair it with a presenter image from the project.
Product release explainers
Animate a product expert's portrait to explain one change, who benefits, and what to try first. Use a short spoken script based on the approved release notes.
Customer onboarding welcomes
Turn a presenter's photo into a welcome that introduces the product and gives new customers one clear next action.
Support answer videos
Use a support presenter's portrait to deliver a concise answer to a recurring question. Keep each clip focused on one problem and its resolution.
Employee training introductions
Animate an instructor's photo to introduce a lesson, explain its purpose, and state what employees should learn.
Weekly team updates
Turn an approved summary and a presenter's portrait into a brief update covering completed work, upcoming priorities, and one action for the audience.
Character-led lessons
Give an illustrated or 3D guide a spoken explanation for a learning activity. Choose a design with clear eyes and lips rather than an exaggerated or obscured face.
Social announcement videos
Animate a spokesperson's portrait for a short announcement with one message and a clear closing line. Match the voice's energy to the announcement.
More on HeyGen Avatar IV and Cursor
Overview
HeyGen Avatar IV in other agents
Questions about HeyGen Avatar IV in Cursor
Can Cursor use HeyGen Avatar IV?
Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run HeyGen Avatar IV like any built-in tool.
How much does HeyGen Avatar IV cost in Cursor?
$0.13 per second of output video. The video is as long as the audio, or the spoken script when there is none. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.
Do I need a fal account to use HeyGen Avatar IV in Cursor?
No. Spiral runs HeyGen Avatar IV 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 Avatar IV in Cursor?
About two minutes: add the hosted server, then sign in.
Does Cursor wait while HeyGen Avatar IV runs?
HeyGen Avatar IV runs in the background. Cursor starts the run, checks on it and gives you the video when it's ready.
What is HeyGen Avatar IV good at?
Use it for a presenter delivering a scripted explanation, update, lesson, or customer message. It turns a single photo into speech with facial expressions and gestures.
Can HeyGen Avatar IV animate a cartoon or 3D character?
Yes. HeyGen recommends Avatar IV for virtual characters, including 2D, 3D, and non-human avatars. Choose a character with a readable face and proportions close to a human face.
Why does lip sync look weak on some characters?
Highly exaggerated facial proportions can reduce lip-sync accuracy and facial movement. Start with a character whose eyes, mouth, and lips are easy to distinguish.
How should I write an Avatar IV script?
Write the words the presenter should say, then punctuate them to reflect the intended pacing. Avatar IV reads pacing and punctuation from the script, so review the text aloud before generating.
How can I make the performance more expressive?
Match the vocal delivery to the intended mood because Avatar IV uses tone, rhythm, and emotion to drive expressions. For a more animated performance, choose the expressive talking style.
Start using HeyGen Avatar IV in Cursor
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Cursor:
set up https://spiral.ai/SKILL.md


