Spiral gives your agent every tool with one account. Browse the tools →

Cursor · Data

How to Use Sa2VA 8B image segmentation in Cursor

Sa2VA 8B returns a text answer and image segmentation masks for a supplied still image. Use it to evaluate image descriptions and object masks with the model that scored 84.4 on MMBench versus 4B's 81.8.

Prompts to try with Sa2VA 8B image segmentation in Cursor

Copy an example into Cursor, or ask in your own words.

Use Sa2VA 8B image segmentation on the supplied NASA Perseverance rover photo. Ask which visible parts belong to the rover and request corresponding masks, then build a review page in this project.

Sa2VA 8B image segmentationCursor
Try asking
  • Use Sa2VA 8B image segmentation on the truck photo at https://raw.githubusercontent.com/facebookresearch/segment-anything-2/main/notebooks/images/truck.jpg. Request separate masks for the truck and building, then add a comparison view for the original image and returned masks.

  • Use Sa2VA 8B image segmentation on the truck photo at https://raw.githubusercontent.com/facebookresearch/segment-anything-2/main/notebooks/images/truck.jpg. Request a truck description and mask, then add the result to this project's annotation viewer.

  • Use Sa2VA 8B image segmentation to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from Sa2VA 8B image segmentation and tell me what changed since last week.

How to set up Sa2VA 8B image segmentation 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):

    {
      "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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Sa2VA 8B image 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/8b/image",
        "input": {
          "prompt": "Could you please give me a brief description of the image? Please respond with interleaved segmentation masks for the corresponding parts of the answer.",
          "image_url": "https://raw.githubusercontent.com/facebookresearch/segment-anything-2/main/notebooks/images/truck.jpg"
        }
      }'

Then paste one of the prompts above: Cursor finds Sa2VA 8B image segmentation on Spiral, shows the price and runs it.

Sa2VA 8B image segmentation providers and prices

Spiral runs Sa2VA 8B image segmentation through fal. Open a card for today's price, with every fee included.

falData
Sa2VA 8B Image · Vision
fal-ai/sa2va/8b/image

What can you do with Sa2VA 8B image segmentation in Cursor?

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.

Questions about Sa2VA 8B image segmentation in Cursor

Can Cursor use Sa2VA 8B image segmentation?

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Sa2VA 8B image segmentation like any built-in tool.

How much does Sa2VA 8B image segmentation cost in Cursor?

$0.052 per image. 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 Sa2VA 8B image segmentation in Cursor?

No. Spiral runs Sa2VA 8B image 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 8B image segmentation in Cursor?

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

Does Cursor wait while Sa2VA 8B image segmentation runs?

Sa2VA 8B image segmentation runs in the background. Cursor starts the run, checks on it and gives you the json 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.

Get started

Start using Sa2VA 8B image segmentation in Cursor

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Cursor:

Set up Cursor

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options