How to Use Sa2VA 4B video segmentation in Gemini CLI
Sa2VA 4B returns a text answer and segmentation mask videos for a supplied clip. Use it to describe visible actions and isolate objects across video rather than in a single still image.
Prompts to try with Sa2VA 4B video segmentation in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Sa2VA 4B video segmentation on the supplied 10-second Big Buck Bunny excerpt. Request a description of visible actions and corresponding object masks, then display the returned text and mask videos in this project's media viewer.
Use Sa2VA 4B video segmentation on the supplied Blender Foundation Sintel trailer excerpt. Request a scene description with masks for the objects discussed, then save the results as review fixtures in this repository.
Use Sa2VA 4B video segmentation to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Sa2VA 4B video segmentation and tell me what changed since last week.
Check Sa2VA 4B video segmentation and summarize what you find in three bullet points.
How to set up Sa2VA 4B video segmentation 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 Sa2VA 4B video segmentation
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/sa2va/4b/video", "input": { "prompt": "Could you please give me a brief description of the video? Please respond with interleaved segmentation masks for the corresponding parts of the answer.", "video_url": "https://drive.google.com/uc?id=1iOFYbNITYwrebBBp9kaEGhBndFSRLz8k" } }'
Then paste one of the prompts above: Gemini CLI finds Sa2VA 4B video segmentation on Spiral, shows the price and runs it.
Sa2VA 4B video segmentation providers and prices
Spiral runs Sa2VA 4B video segmentation through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Sa2VA 4B video segmentation works from your prompt and video URL. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of frames to sample | 5 to 100 | Number of frames to sample from the video. Defaults to 32 if not provided. Minimum 5, maximum 100. |
Every API field of Sa2VA 4B Video · Vision is on its tool page: open its card above.
What can you do with Sa2VA 4B video segmentation in Gemini CLI?
Build a media review screen that places Sa2VA descriptions beside the corresponding object masks. A coding agent can work with your project's image and video assets and add the returned results to an annotation review workflow.
Draft visual descriptions
Ask Sa2VA to describe a product photo or demonstration clip, then use the answer as a draft for a media caption.
Prepare annotation drafts
Request object descriptions with corresponding masks for an image or video dataset. Give annotators the text and masks together for review.
Catalog product media
Describe visible products, colors, and surroundings in catalog photos and demonstration videos. Use the descriptions to draft searchable asset labels.
Prepare masks for editing
Name the object an editor needs to isolate and request its segmentation mask. Review the returned image mask or mask video before using it in an editing workflow.
Review generated media
Ask specific questions about objects and their relationships in generated stills or clips. Compare the answers and masks with the creative brief during review.
Create visual teaching material
Use licensed illustrations or animation clips to draft object descriptions and visual questions. Request matching masks to highlight the regions discussed in a lesson.
More on Sa2VA 4B video segmentation and Gemini CLI
Overview
Sa2VA 4B video segmentation in other agents
Questions about Sa2VA 4B video segmentation in Gemini CLI
Can Gemini CLI use Sa2VA 4B video segmentation?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Sa2VA 4B video segmentation like any built-in tool.
How much does Sa2VA 4B video segmentation cost in Gemini CLI?
Up to $3.12 per run at the default inputs for 60 seconds of input. 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 Sa2VA 4B video segmentation in Gemini CLI?
No. Spiral runs Sa2VA 4B video segmentation on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Sa2VA 4B video segmentation in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Sa2VA 4B video segmentation runs?
Sa2VA 4B video segmentation runs in the background. Gemini CLI starts the run, checks on it and gives you the text when it's ready.
What does Sa2VA return besides a description?
Its documented outputs include generated text and segmentation masks. Image analysis returns image masks; video analysis returns mask video files.
Can Sa2VA fetch media behind a login?
Externally hosted media URLs must be publicly accessible. A link that requires a website login falls outside that documented boundary.
How do the published 4B and 8B results compare?
ByteDance reports MMBench scores of 81.8 for 4B and 84.4 for 8B. On the MeVIS video segmentation benchmark, it reports 55.9 and 58.9 respectively; these are benchmark scores, not accuracy percentages for your media.
How should I ask for segmentation masks?
Explicitly request masks for the objects discussed in the answer. ByteDance's example asks for interleaved segmentation masks corresponding to parts of the description.
Which scenes need closer review?
The Sa2VA paper identifies occlusion and long referring descriptions as challenges. It also calls out longer videos with camera motion, so review those results closely before using the masks as annotations.
Start using Sa2VA 4B video segmentation 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


