[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Vidu Template to Video](https://spiral.ai/integrations/cursor/vidu-template-to-video)

# How to Use Vidu Template to Video in Cursor

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.

|  |  |
| --- | --- |
| Model | Vidu Template to Video |
| Available through | fal |
| Category | Video |
| Price | Up to $0.65 per run at the default inputs. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Vidu Template to Video in Cursor

- 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 Cursor

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

### Use Spiral's MCP server

1. **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):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **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

1. **Send Cursor 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 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 Vidu Template to Video**: 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": "fal",
    "model": "fal-ai/vidu/template-to-video",
    "input": {
      "input_image_urls": [
        "<input_image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Cursor finds Vidu Template to Video on Spiral, shows the price and runs it.

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

## Vidu Template to Video tools and prices

- [Vidu · Template to Video](https://spiral.ai/tools/fal/fal-ai/vidu/template-to-video) (fal): Up to $0.65 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| template | dreamy_wedding, romantic_lift, sweet_proposal, couple_arrival, cupid_arrow, pet_lovers, lunar_newyear, hug, kiss, dynasty_dress, wish_sender, love_pose, hair_swap, youth_rewind, morphlab, live_photo, emotionlab, live_memory, interaction, christmas, pet_finger, eat_mushrooms, beast_chase_library, beast_chase_supermarket, petal_scattered, emoji_figure, hair_color_change, multiple_people_kissing, beast_chase_amazon, beast_chase_mountain, balloonman_explodes_pro, get_thinner, jump2pool, bodyshake, jiggle_up, shake_it_dance, subject_3, pubg_winner_hit, shake_it_down, blueprint_supreme, hip_twist, motor_dance, rat_dance, kwok_dance, leg_sweep_dance, heeseung_march, shake_to_max, dame_un_grrr, i_know, lit_bounce, wave_dance, chill_dance, hip_flicking, sakura_season, zongzi_wrap, zongzi_drop, dragonboat_shot, rain_kiss, child_memory, couple_drop, couple_walk, flower_receive, love_drop, cheek_kiss, carry_me, blow_kiss, love_fall, french_kiss_8s, workday_feels, love_story, bloom_magic, ghibli, minecraft, box_me, claw_me, clayshot, manga_meme, quad_meme, pixel_me, clayshot_duo, irasutoya, american_comic, simpsons_comic, yayoi_kusama_style, pop_art, jojo_style, slice_therapy, balloon_flyaway, flying, paperman, pinch, bloom_doorobear, gender_swap, nap_me, sexy_me, spin360, smooth_shift, paper_fall, jump_to_cloud, pilot, sweet_dreams, soul_depart, punch_hit, watermelon_hit, split_stance_pet, make_face, break_glass, split_stance_human, covered_liquid_metal, fluffy_plunge, pet_belly_dance, water_float, relax_cut, head_to_balloon, cloning, across_the_universe_jungle, clothes_spinning_remnant, across_the_universe_jurassic, across_the_universe_moon, fisheye_pet, hitchcock_zoom, cute_bangs, earth_zoom_out, fisheye_human, drive_yacht, virtual_singer, earth_zoom_in, aliens_coming, drive_ferrari, bjd_style, virtual_fitting, orbit, zoom_in, ai_outfit, spin180, orbit_dolly, orbit_dolly_fast, auto_spin, walk_forward, outfit_show, zoom_in_fast, zoom_out_image, zoom_out_startend, muscling, captain_america, hulk, cap_walk, hulk_dive, exotic_princess, beast_companion, cartoon_doll, golden_epoch, oscar_gala, fashion_stride, star_carpet, flame_carpet, frost_carpet, mecha_x, style_me, tap_me, saber_warrior, pet2human, graduation, fishermen, happy_birthday, fairy_me, ladudu_me, ladudu_me_random, squid_game, superman, grow_wings, clevage, fly_with_doraemon, creatice_product_down, pole_dance, hug_from_behind, creatice_product_up_cybercity, creatice_product_up_bluecircuit, creatice_product_up, run_fast, background_explosion | 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 |  | — | Random seed for generation |
| aspect_ratio | 16:9, 9:16 | 16:9 | The aspect ratio of the output video |

## What can you do with Vidu Template to Video in Cursor?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## Vidu Template to Video in other agents

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

## More Cursor guides

- [Vidu Start-End to Video](https://spiral.ai/integrations/cursor/vidu-start-end-to-video)
- [Vizard AI Clip v1](https://spiral.ai/integrations/cursor/vizard-ai-clip-v1)
- [Vidu Reference to Video](https://spiral.ai/integrations/cursor/vidu-reference-to-video)
- [Wan 2.2 5B Image to Video](https://spiral.ai/integrations/cursor/wan-2-2-5b-image-to-video)
- [Vidu Q4 Reference to Video](https://spiral.ai/integrations/cursor/vidu-q4-reference-to-video)
- [Wan 2.2 5B Text to Video](https://spiral.ai/integrations/cursor/wan-2-2-5b-text-to-video)

## Questions about Vidu Template to Video in Cursor

**Can Cursor use Vidu Template to Video?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Vidu Template to Video like any built-in tool.

**How much does Vidu Template to Video cost in Cursor?**

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 Cursor plan is separate.

**Do I need a fal account to use Vidu Template to Video in Cursor?**

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 Cursor?**

About two minutes: add the hosted server, then sign in.

**Does Cursor wait while Vidu Template to Video runs?**

Vidu Template to Video runs in the background. Cursor 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.

