How to Use Vidu Template to Video in Claude Code
Vidu Template to Video turns photos into preset effects, including hugs, pet dives, and pixel-style animation. Choose it when a ready-made action fits your clip and you want to avoid writing detailed motion instructions.
Prompts to try with Vidu Template to Video in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Vidu Template to Video to animate the couple's photo in public/images with the hug effect. Save the result as an anniversary greeting asset and add a replay control to its preview.
Use Vidu Template to Video with the pet diving effect on the full-body dog photo in the project's assets. Add the result to our pet gallery with a static image preview.
Use Vidu Template to Video to turn the creator portrait in public/images into a pixel-style anime clip. Add it to the introduction screen with a play button.
Use Vidu Template to Video with the glass breaking effect on the human character portrait in our assets. Build a preview that lets me inspect the clip before adding it to the game trailer.
Use Vidu Template to Video to make a blown kiss greeting from the portrait in the project. Add the clip to the thank-you page with playback controlled by the visitor.
How to set up Vidu Template to Video in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code 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 Vidu Template to Video
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/vidu/template-to-video", "input": { "input_image_urls": [ "<input_image_urls>" ] } }'
Then paste one of the prompts above: Claude Code finds Vidu Template to Video on Spiral, shows the price and runs it.
Vidu Template to Video providers and prices
Spiral runs Vidu Template to Video through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Template | dreamy_wedding, romantic_lift, sweet_proposal, couple_arrival, cupid_arrow, pet_lovers, lunar_newyear, hug and 173 more | hug | AI video template to use. Pricing varies by template: Standard templates (hug, kiss, love_pose, etc.) cost 4 credits ($0.20), Premium templates (lunar_newyear, dynasty_dress, dreamy_wedding, etc.) cost 6 credits ($0.30), and Advanced templates (live_photo) cost 10 credits ($0.50). |
| Seed | a whole number | Random seed for generation | |
| Aspect ratio | 16:9 or 9:16 | 16:9 | The aspect ratio of the output video |
Every API field of Vidu · Template to Video is on its tool page: open its card above.
What can you do with Vidu Template to Video in Claude Code?
Create animated assets from project images for greetings, character scenes, and social previews. A coding agent can place the generated clips in the project and build the surrounding playback experience.
Anniversary greeting
Apply the hug effect to a couple's photo and use the generated embrace in an anniversary message.
Illustrated character reunion
Animate two illustrated characters embracing for a reunion scene or a character greeting.
Pet account comedy clip
Turn a clear, full-body dog or cat photo into a diving clip for a pet account.
Pixel-style creator introduction
Transform a creator's portrait into pixel-style animation for an introduction to a gaming or anime post.
Action reaction clip
Animate a human portrait punching through glass for a playful reaction insert in a gaming edit.
Personal video greeting
Turn a portrait into a blown kiss clip for a thank-you message or personal greeting.
More on Vidu Template to Video and Claude Code
Overview
Vidu Template to Video in other agents
Questions about Vidu Template to Video in Claude Code
Can Claude Code use Vidu Template to Video?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Vidu Template to Video like any built-in tool.
How much does Vidu Template to Video cost in Claude Code?
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 Claude Code plan is separate.
Do I need a fal account to use Vidu Template to Video in Claude Code?
No. Spiral runs Vidu Template to Video on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Vidu Template to Video in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Vidu Template to Video runs?
Vidu Template to Video runs in the background. Claude Code starts the run, checks on it and gives you the video when it's ready.
What is Vidu Template to Video good for?
It is useful for turning an existing photo into a recognizable action or visual effect. Examples include an embrace, a pet diving into water, or a portrait transformed into pixel-style animation.
How should I describe the motion I want?
Start by matching your idea to an existing effect. For a hug, Vidu's preset supplies the action without written motion instructions, so focus your request on the source image and intended use.
Can Vidu Template to Video animate illustrated characters?
Vidu explicitly describes the hug effect as working with people or characters. That makes it useful for an illustrated reunion or character greeting.
What photo works best for a pet diving clip?
Choose a clear photo with the entire pet visible. Vidu identifies full-body visibility as the best starting point for this effect.
Can I turn a selfie into pixel-style animation?
Yes. Vidu's pixel anime effect is designed to turn realistic portraits into animated pixel-style videos.
Start using Vidu Template to Video in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


