SAM 3 Image

Name: Meta SAM 3 Image
Price: 0.005 USD
Availability: InStock
Author: Meta

meta/sam-3/image

SAM 3 Image is Meta's segmentation model. It finds objects in an image from a text, point, or box prompt and returns masks and the masked image, with optional confidence scores.

Use in agent Get API key

Base price: $0.005USD / run
Execution: async
Model type: image
Input fields: 11

Production route

Try the model

Playground

Open playground

Input

Prompt(string)

Text prompt for segmentation

Image Url(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

URL of the image to be segmented

This field is required.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png.

Box Prompts(array)

Box prompt coordinates (x_min, y_min, x_max, y_max). Multiple boxes supported - use object_id to group boxes for the same object or leave empty for separate objects.

Text Prompt(string)

[DEPRECATED] Use 'prompt' instead. Kept for backward compatibility.

Include Scores(boolean)

Whether to include mask confidence scores.

Apply Mask(boolean)

Apply the mask on the image.

Point Prompts(array)

List of point prompts

Return Multiple Masks(boolean)

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

Max Masks(integer)

132

Maximum number of masks to return when `return_multiple_masks` is enabled. Range: 1 to 32.

Include Boxes(boolean)

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

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0.005 / run

Context & modalities

Input: Schema-defined
Output: image

Capabilities

Chat: Not supported
Vision: Not supported
Reasoning: Not supported
Structured output: Not supported
Function calling: Not supported
Audio input: Not supported

Access

Provider: Meta
Model ID: meta/sam-3/image
Execution: async
Base URL: https://api.sandbase.ai
API: Unified Run API
Endpoint: /v1/run

API README

SAM 3 Image

SAM 3 segments objects in an image from a text, point, or box prompt and returns masks.

Fields

Field	Type	Default	Notes
`prompt`	string, required	`wheel`	What to segment, e.g. “the red car”.
`image`	image URL, required	—	Image to segment. JPEG, PNG, or WebP URL.
`output_format`	`jpeg` / `png`	`png`	Output file format.
`box_prompts`	item[]	`[]`	Optional boxes.
`text_prompt`	string	—	[DEPRECATED] Use 'prompt' instead.
`include_scores`	boolean	false	Whether to include mask confidence scores.
`apply_mask`	boolean	true	Return the masked image.
`point_prompts`	item[]	`[]`	Optional points.
`return_multiple_masks`	boolean	false	If True, upload and return multiple generated masks as defined by `max_masks`.
`max_masks`	integer 1–32	3	Maximum masks to return.
`include_boxes`	boolean	false	Whether to include bounding boxes for each mask (when available).

Billing

$0.005 per image.

Request	Price
One image	$0.005

Failed runs are not charged.

Also on SandBase

Related: meta/sam-3/3d-objects.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API

Unified Run API endpoint

https://api.sandbase.ai/v1/run

Model ID

meta/sam-3/image

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "meta/sam-3/image",
  "image": "https://raw.githubusercontent.com/facebookresearch/segment-anything-2/main/notebooks/images/truck.jpg",
  "prompt": "wheel",
  "max_masks": 3,
  "apply_mask": true,
  "box_prompts": [],
  "include_boxes": false,
  "output_format": "png",
  "point_prompts": [],
  "include_scores": false,
  "return_multiple_masks": false
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models

Model	Type	Default price	Released
SAM 3 ImageThis model `Meta`	Image	$0.01 / run	Nov 20, 2025
SAM 3 3D Objects `Meta`	Image	$0.02 / run	Dec 2, 2025

Questions

FAQ

How do I call Meta SAM 3 Image through SandBase?

Create a SandBase API key, then send requests with the model ID "meta/sam-3/image" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Meta account?

No. One SandBase API key and balance gives you access to Meta SAM 3 Image and the other models in the catalog; you do not need to sign up with Meta separately.