How to Use EVF-SAM2 in Grok
EVF-SAM2 turns an English description into a selection mask for an existing image. Use it to isolate a named object or select hair and background regions with semantic segmentation for later editing.
Prompts to try with EVF-SAM2 in Grok
Copy an example into Grok, or ask in your own words.
Use EVF-SAM2 on this photo to select the red cup beside the plate. Return the selection mask so I can review it.
Use EVF-SAM2 on this portrait to select hair using semantic segmentation. Show the mask before I use it for a color change.
Use EVF-SAM2 on this product photo to select the handbag on the right. Prepare a mask for a later background edit.
Use EVF-SAM2 on this table photo to select the plate and exclude the fork. Show me the resulting mask.
Use EVF-SAM2 on this beach photo to select the sea using semantic segmentation. Return a mask for a separate color adjustment.
How to set up EVF-SAM2 in Grok
Pick the way that suits you. Each takes about two minutes.
Use the Grok connector
- Add a custom connector
In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.
- Check that it is connected
Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.
Use the Spiral skill
- Send Grok 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 EVF-SAM2
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/evf-sam", "input": { "prompt": "Cat in the middle of the image", "image_url": "https://storage.googleapis.com/falserverless/web-examples/evf-sam2/evfsam2-cat.png" } }'
Then paste one of the prompts above: Grok finds EVF-SAM2 on Spiral, shows the price and runs it.
EVF-SAM2 providers and prices
Spiral runs EVF-SAM2 through fal. Open a card for today's price, with every fee included.
Settings you can ask for
EVF-SAM2 works from your prompt and image URL. Ask Grok for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Negative prompt | what to leave out, in words | Areas to exclude from segmentation (will be subtracted from prompt results) | |
| Semantic type | on or off | off | Enable semantic level segmentation for body parts, background or multi objects |
| Mask only | on or off | on | Output only the binary mask instead of masked image |
| Use grounding dino | on or off | off | Use GroundingDINO instead of SAM for segmentation |
| Revert mask | on or off | off | Invert the mask (background becomes foreground and vice versa) |
| Blur mask | 0 to 50 | 0 | Apply Gaussian blur to the mask. Value determines kernel size (must be odd number) |
| Expand mask | 0 to 20 | 0 | Expand/dilate the mask by specified pixels |
| Fill holes | on or off | off | Fill holes in the mask using morphological operations |
Every API field of EVF-SAM2 Segmentation is on its tool page: open its card above.
What can you do with EVF-SAM2 in Grok?
Select a specific object or region in a photo by describing it in ordinary English. Use EVF-SAM2 to prepare a mask for an edit and inspect the selection before proceeding.
Product selections for recoloring
Use EVF-SAM2 to mask a specific shoe, bag, or chair in a product photo, then pass the selection to an editing tool.
Background replacement preparation
Use EVF-SAM2 with semantic segmentation to select a photo's background before replacing it in a separate editing step.
Hair color previews
Use EVF-SAM2 with semantic segmentation to select hair for a color preview. Inspect the selection before applying the edit.
One object in a crowded photo
Use EVF-SAM2 to select a target by its location or relationship to another object, such as the cup beside a plate.
Draft annotation masks
Use EVF-SAM2 to propose object masks from English descriptions, then have an annotator review them before adding them to a dataset.
Landscape editing selections
Use EVF-SAM2 with semantic segmentation to select a region such as the sea for a later color adjustment.
More on EVF-SAM2 and Grok
Overview
EVF-SAM2 in other agents
Questions about EVF-SAM2 in Grok
Can Grok use EVF-SAM2?
Yes. Add Spiral to Grok as an MCP server, and Grok can find and run EVF-SAM2 like any built-in tool.
How much does EVF-SAM2 cost in Grok?
$0.0065 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 Grok plan is separate.
Do I need a fal account to use EVF-SAM2 in Grok?
No. Spiral runs EVF-SAM2 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up EVF-SAM2 in Grok?
About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.
Does Grok wait while EVF-SAM2 runs?
EVF-SAM2 runs in the background. Grok starts the run, checks on it and gives you the image when it's ready.
What is EVF-SAM2 useful for?
Use EVF-SAM2 to select a region in an existing image by describing it. The resulting mask can serve as the selection for a later edit, such as changing a product's color or replacing a background.
How do I select one object when several look alike?
Name the object and add a visible detail or location, such as 'the red cup beside the plate.' EVF-SAM supports spatial descriptions, so a relationship to another object can help distinguish your target.
Which language should I use for EVF-SAM2 prompts?
Use English. The official demo specifies English-only support, so translate other languages before submitting the target description.
Can EVF-SAM2 select hair or a background region?
Yes. Use semantic segmentation for body parts, background regions, or multiple objects, then describe the region you want.
How do I exclude something from a selection?
Describe the region to keep in the positive description and the unwanted region in the negative description. EVF-SAM2 subtracts the negative selection from the positive result.
Start using EVF-SAM2 in Grok
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Grok:
set up https://spiral.ai/SKILL.md


