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

Hermes · ImageReleased 2025-11-19

How to Use SAM 3 Image in Hermes

SAM 3 Image finds and masks objects in existing photos using short descriptions or visual guidance. Use it to prepare product cutouts, editing selections, and annotation drafts.

Prompts to try with SAM 3 Image in Hermes

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

Each morning, use SAM 3 Image to select 'table lamp' in newly submitted product photos. Prepare a review gallery of the selections before cutout editing.

SAM 3 ImageHermes
Try asking
  • Every afternoon, use SAM 3 Image to find 'chair' in new room survey photos. Report proposed counts with marked previews for review.

  • Each day, use SAM 3 Image to draft 'dog' masks in newly submitted training images. Send the selections to the annotation review queue.

  • Each evening, use SAM 3 Image to locate 'license plate' in new vehicle photos. Queue marked previews for review before the redaction step.

  • Each morning, use SAM 3 Image to select 'bird' in new camera-trap stills. Prepare the masks for review and leave species identification to the reviewer.

How to set up SAM 3 Image in Hermes

Pick the way that suits you. Each takes about two minutes.

Use the Spiral skill

  1. Send Hermes 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 Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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 SAM 3 Image

    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/sam-3/image",
        "input": {
          "image_url": "https://raw.githubusercontent.com/facebookresearch/segment-anything-2/main/notebooks/images/truck.jpg"
        }
      }'

Then paste one of the prompts above: Hermes finds SAM 3 Image on Spiral, shows the price and runs it.

SAM 3 Image providers and prices

Spiral runs SAM 3 Image through fal. Open a card for today's price, with every fee included.

falImage

Settings you can ask for

SAM 3 Image works from your image URL and prompt. Ask Hermes for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Apply maskon or offon

Apply the mask on the image.

Output formatjpeg, png, or webppng

The format of the generated image.

Return multiple maskson or offoff

If True, upload and return multiple generated masks as defined by max_masks.

Max masks1 to 323

Maximum number of masks to return when return_multiple_masks is enabled.

Include scoreson or offoff

Whether to include mask confidence scores.

Include boxeson or offoff

Whether to include bounding boxes for each mask (when available).

Every API field of Segment Anything Model 3 · Image to Image is on its tool page: open its card above.

What can you do with SAM 3 Image in Hermes?

Prepare object selections from incoming images for recurring review work. Keep the source images and mask previews together so a person can check each batch.

Product cutout preparation

Select a photographed product with a description such as 'table lamp.' Pass the mask to an editor for background removal or a new composition.

Selective photo editing

Mask a jacket, chair, or other object before applying a color adjustment in an image editor. Review the selection before changing the pixels.

Object count review

Find matching objects such as apples or chairs and use the masks to check a proposed count. Keep a marked preview so a person can spot missed or duplicate selections.

Annotation drafts

Create initial object masks for an image dataset using short category descriptions. Have an annotator correct the selections before accepting the labels.

Privacy redaction preparation

Locate faces, license plates, or screens before a separate pixelation step. Inspect the whole image for missed targets before publishing.

Interior design selections

Isolate furniture in a room photo to prepare a mood board or editing selection. Use descriptions such as 'armchair' or 'floor lamp' for each pass.

Wildlife image annotation

Draft animal masks in camera-trap stills with broad descriptions such as 'bird' or 'deer.' Treat exact species identification as a separate review task.

Questions about SAM 3 Image in Hermes

Can Hermes use SAM 3 Image?

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run SAM 3 Image like any built-in tool.

How much does SAM 3 Image cost in Hermes?

$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 Hermes plan is separate.

Do I need a fal account to use SAM 3 Image in Hermes?

No. Spiral runs SAM 3 Image on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up SAM 3 Image in Hermes?

About two minutes: add the server and sign in, then check it.

Does Hermes wait while SAM 3 Image runs?

SAM 3 Image runs in the background. Hermes starts the run, checks on it and gives you the image when it's ready.

What does SAM 3 produce?

SAM 3 produces segmentation masks that mark which pixels belong to matching objects in an existing image. Those selections can feed a separate editing, counting, or annotation step.

How should I phrase a SAM 3 prompt?

Use a short object description such as 'red apple' or 'striped cat.' Keep it to the object and one or two visible attributes.

Can SAM 3 select several matching objects?

Yes. SAM 3 is designed to find all instances matching a concept, such as the chairs in a room. Review the selections before treating them as a complete count.

Can SAM 3 follow a detailed instruction about an object's position?

Long descriptions such as 'the second to last book from the right on the top shelf' exceed its intended text prompting capabilities. Use a simpler description and visual guidance to identify the target.

Where does SAM 3 need extra review?

Specialized categories in unfamiliar imagery need particular care. Meta reports difficulty with fine-grained concepts requiring domain knowledge, so review scientific and medical selections closely.

Get started

Start using SAM 3 Image in Hermes

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

Paste this into Hermes:

Set up Hermes

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