How to Use PixVerse V4 Image to Video in Gemini CLI
PixVerse V4 Image to Video animates a still image into a short shot, using the image as its opening frame. Unlike PixVerse V4 Image to Video Fast, it supports 1080p output and eight-second clips at lower resolutions.
Prompts to try with PixVerse V4 Image to Video in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use PixVerse V4 Image to Video to animate the product still in the project's assets folder at 1080p for five seconds. Request a slow camera push toward the product and keep its shape and packaging recognizable.
Animate the image I attach with PixVerse V4 Image to Video: slow push-in, leaves moving in the wind. Save the result in ./assets.
Turn this product photo into a 5-second rotating shot with PixVerse V4 Image to Video.
Bring this portrait to life with PixVerse V4 Image to Video: a subtle smile and a blink.
Animate this illustration with PixVerse V4 Image to Video: clouds drifting, a slow camera pan to the right.
How to set up PixVerse V4 Image to Video in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 PixVerse V4 Image 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/pixverse/v4/image-to-video", "input": { "prompt": "A woman warrior with her hammer walking with his glacier wolf.", "image_url": "https://v3.fal.media/files/zebra/qL93Je8ezvzQgDOEzTjKF_KhGKZTEebZcDw6T5rwQPK_output.png" } }'
Then paste one of the prompts above: Gemini CLI finds PixVerse V4 Image to Video on Spiral, shows the price and runs it.
PixVerse V4 Image to Video providers and prices
Spiral runs PixVerse V4 Image to Video through fal. Open a card for today's price, with every fee included.
$0.26 per run at the default inputs. resolution: 360p $0.195, 540p $0.195, 720p (default) $0.26, 1080p $0.52.
Settings you can ask for
PixVerse V4 Image to Video works from your prompt and image URL. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Resolution | 360p, 540p, 720p, or 1080p | 720p | The resolution of the generated video |
| Duration | 5 or 8 | 5 | The duration of the generated video in seconds. 8s videos cost double. 1080p videos are limited to 5 seconds |
| Negative prompt | what to leave out, in words | Negative prompt to be used for the generation. Limited to 2048 UTF-8 encoded bytes. Because the limit counts bytes rather than characters, emoji and non-Latin or accented characters (which use multiple bytes each) can push a visually short prompt over the cap. | |
| Style | anime, 3d_animation, clay, comic, or cyberpunk | The style of the generated video | |
| Seed | a whole number | The same seed and the same prompt given to the same version of the model will output the same video every time. | |
| Camera movement | horizontal_left, horizontal_right, vertical_up, vertical_down, zoom_in, zoom_out, crane_up, quickly_zoom_in and 12 more | The type of camera movement to apply to the video |
Every API field of PixVerse V4 · Image to Video is on its tool page: open its card above.
What can you do with PixVerse V4 Image to Video in Gemini CLI?
Create short visual assets for a project from its creative brief. Have the coding agent turn project notes into focused shots and prepare the results for review alongside the interface.
Short ad concepts
Test one advertising idea per shot, such as steam rising from a coffee cup. Describe the scene from scratch or animate an approved still.
Storyboard motion tests
Explore how a character enters a scene or turns toward the camera. Start with a written shot description or an existing storyboard panel.
Atmospheric cutaways
Create a brief shot of rain, drifting mist, or leaves moving in window light. Build the setting from text or introduce motion into a landscape still.
Stylized character beats
Try a clay character waving or an anime character looking up. Describe a new character or begin with an illustration, keeping the action brief.
Product photo animation
Animate an approved product photo with a restrained camera move. Review the result for changes to the product's shape, packaging, and visible details.
Illustration motion studies
Use an illustration as the opening frame and request one movement, such as a scarf fluttering. Focus the prompt on motion and the appearance details that must remain recognizable.
More on PixVerse V4 Image to Video and Gemini CLI
Overview
PixVerse V4 Image to Video in other agents
Questions about PixVerse V4 Image to Video in Gemini CLI
Can Gemini CLI use PixVerse V4 Image to Video?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run PixVerse V4 Image to Video like any built-in tool.
How much does PixVerse V4 Image to Video cost in Gemini CLI?
$0.26 per run at the default inputs. `resolution`: 360p $0.195, 540p $0.195, 720p (default) $0.26, 1080p $0.52. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need a fal account to use PixVerse V4 Image to Video in Gemini CLI?
No. Spiral runs PixVerse V4 Image 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 PixVerse V4 Image to Video in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while PixVerse V4 Image to Video runs?
PixVerse V4 Image to Video runs in the background. Gemini CLI starts the run, checks on it and gives you the video when it's ready.
What is PixVerse V4 useful for?
Use it for short visual shots: ad concepts, storyboard tests, atmospheric cutaways, and animated character beats. Plan a single visible action for each shot.
How should I write a PixVerse V4 prompt?
Start with the subject, what it does, and where it is. Add concrete lighting and framing details, then remove repeated description.
Can PixVerse V4 create a complete long scene in one generation?
Treat it as a tool for short shots. For a longer story, plan separate clips and edit them together instead of packing the entire sequence into one prompt.
How can I compare changes to a prompt?
Keep the seed and output settings fixed, then change one instruction at a time. Save the exact prompt and model name with each result so you can revisit a useful baseline.
Can PixVerse V4 make stylized animation?
Yes, it supports treatments such as anime and clay. Use the selected treatment for appearance, and spend the prompt on what the subject does and how the shot is framed.
Start using PixVerse V4 Image to Video in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


