How to Use HeyGen Avatar IV Digital Twin in opencode
HeyGen Avatar IV Digital Twin makes talking-presenter videos for lessons, product explanations, and personal messages. It uses an avatar built from recorded footage, with facial expressions shaped by the narration's tone, rhythm, and emotion.
Prompts to try with HeyGen Avatar IV Digital Twin in opencode
Copy an example into opencode, or ask in your own words.
Read CHANGELOG.md and draft a spoken release summary with short sentences. Use the approved recording at media/release-summary.wav with HeyGen Avatar IV Digital Twin to create a 1080p presenter segment.
Use HeyGen Avatar IV Digital Twin with media/onboarding.wav to make a 720p presenter draft. Compare its narration with README.md and flag any outdated instructions before final editing.
Read docs/quickstart.md and outline a tutorial with separate presenter and screen-recording segments. Render media/quickstart-intro.wav with HeyGen Avatar IV Digital Twin at 1080p for the opening.
Create a 1080p presenter video from media/feature-overview.wav using HeyGen Avatar IV Digital Twin. Keep the interface demonstration as a separate clip in the project's video edit.
Use HeyGen Avatar IV Digital Twin to render media/faq-answer.wav at 720p. Check the spoken terminology against docs/faq.md and list corrections needed in the narration.
How to set up HeyGen Avatar IV Digital Twin in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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 Digital Twin
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/digital-twin", "input": { "character": { "avatar": "Florin Business Sitting Side" }, "voice": {} } }'
Then paste one of the prompts above: opencode finds HeyGen Avatar IV Digital Twin on Spiral, shows the price and runs it.
HeyGen Avatar IV Digital Twin providers and prices
Spiral runs HeyGen Avatar IV Digital Twin through fal. Open a card for today's price, with every fee included.
Settings you can ask for
HeyGen Avatar IV Digital Twin works from your audio URL. Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| 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. |
Every API field of HeyGen Avatar IV Digital Twin is on its tool page: open its card above.
What can you do with HeyGen Avatar IV Digital Twin in opencode?
Turn project explanations into presenter videos for release announcements, onboarding, and tutorials. Use project files to prepare accurate narration, then render an approved recording and add screen footage separately.
Release announcements
Turn approved release narration into a presenter video explaining what changed and who benefits.
Short training lessons
Create a presenter segment for one procedure or concept, then pair it with supporting slides during editing.
Customer welcome messages
Use a warm recorded greeting to introduce the next steps for a new customer.
Product explanations
Give a product overview a visible presenter, with screen recordings added separately where viewers need to see the interface.
Answers to common questions
Make a short presenter video answering one recurring question with an approved explanation.
Recurring team updates
Convert approved weekly narration into a presenter briefing covering decisions, progress, and next steps.
Event introductions
Create a recorded presenter introduction that welcomes attendees and explains the session's purpose.
More on HeyGen Avatar IV Digital Twin and opencode
Overview
HeyGen Avatar IV Digital Twin in other agents
Questions about HeyGen Avatar IV Digital Twin in opencode
Can opencode use HeyGen Avatar IV Digital Twin?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run HeyGen Avatar IV Digital Twin like any built-in tool.
How much does HeyGen Avatar IV Digital Twin cost in opencode?
Up to $0.65 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need a fal account to use HeyGen Avatar IV Digital Twin in opencode?
No. Spiral runs HeyGen Avatar IV Digital Twin 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 Digital Twin in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while HeyGen Avatar IV Digital Twin runs?
HeyGen Avatar IV Digital Twin runs in the background. opencode starts the run, checks on it and gives you the video when it's ready.
What is HeyGen Avatar IV Digital Twin good for?
Use it for presenter-led explanations, lessons, updates, and personal messages. Its focus is a person delivering narration with matching facial movement.
What shapes the presenter's expression?
Avatar IV analyzes the narration's vocal tone, rhythm, and emotion. Choose a recording whose delivery already suits the message, such as a warm welcome or a measured explanation.
How should I write narration for Avatar IV?
Write for speaking: use short sentences and clear punctuation. When preparing synthesized narration, commas create short pauses, periods separate sentences, and ellipses create longer pauses.
Does Avatar IV generate native 4K video?
No. HeyGen says Avatar IV API output is not native 4K; a 4K request on HeyGen's API produces an upscaled 1080p render.
Which visual details need careful review?
Check clothing logos, lettering, and busy patterns. HeyGen warns that these can produce artifacts or distortions in avatar Looks.
Start using HeyGen Avatar IV Digital Twin in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


