Vidu · Template to Video
fal-ai/vidu/template-to-videoGenerate and edit video with Vidu · Template to Video from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
Up to $0.65 per run at the default inputs.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 1 hour
- Longest run, end to end
- 930 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
template | one of 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). |
input_image_urls required | list | — | URLs of the images to use with the template. Number of images required varies by template: 'dynasty_dress' and 'shop_frame' accept 1-2 images, 'wish_sender' requires exactly 3 images, all other templates accept only 1 image. |
seed | number (whole) | — | Random seed for generation |
aspect_ratio | one of 16:9, 9:16 | 16:9 | The aspect ratio of the output video |
Same request in code
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>"
]
}
}'Frequently asked questions
How much does Vidu · Template to Video cost?
Up to $0.65 per run at the default inputs. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Vidu · Template to Video through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/vidu/template-to-video"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use Vidu · Template to Video?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Vidu · Template to Video?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.