SandBase is live — $1 in free credits on signupStart free ›
Start building
Use in agentMeta models

Meta modelsimage generation api

meta/sam-3-1/image

Sam 3 1 Image is Meta's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Input
Text prompt for segmentation

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

URL of the image to be segmented
The format of the generated image. Allowed values: jpeg, png.
Apply the mask on the image.
132
Maximum number of masks to return when `return_multiple_masks` is enabled. Range: 1 to 32.
Whether to include bounding boxes for each mask (when available).
Whether to include mask confidence scores.
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.
If True, upload and return multiple generated masks as defined by `max_masks`.
List of point prompts
Idle

Example output — click Run to generate your own

API README

Sam 3 1 Image

Sam 3 1 Image is built for promptable segmentation and reconstruction, with this exact route focused on still-image mask extraction. Sam 3 1 Image is Meta's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion. It is designed for production workflows that need a clearly scoped media operation instead of a generic assistant response, preserving the supplied direction while returning an artifact ready for review, iteration, or downstream assembly.

The request surface keeps creative direction and delivery choices explicit through prompt, image_url, max_masks, sync_mode, apply_mask, box_prompts. Teams can lock source material, describe the intended result, choose supported output controls, and rerun the same request structure across variations. This makes experiments easier to compare and larger pipelines easier to operate without hiding important decisions inside an opaque preset.

Highlights

  • Still-Image Mask Extraction. The meta/sam-3-1/image route is dedicated to still-image mask extraction, keeping inputs and outputs matched to this operation.
  • Precise Spatial Selection. Within meta/sam-3-1/image, documented prompt and media controls direct precise spatial selection while keeping the brief close to the result.
  • Structured Masks Or Geometry. The meta/sam-3-1/image result provides structured masks or geometry in a machine-consumable form for review and downstream production.
  • Route-specific control. For meta/sam-3-1/image, documented controls include prompt, image_url, max_masks, sync_mode, apply_mask, box_prompts, defining the supported variation space for this exact route.

Pricing

ConfigurationPrice
Per request$0.010000

When to Use

ScenarioWhy it fits
Choose this routeWhen the deliverable is specifically still-image mask extraction, not a neighboring generation or editing task.
Production iterationWhen creative teams need repeatable precise spatial selection with an explicit request payload.
Automated pipelinesWhen structured masks or geometry must flow into review, storage, compositing, or publishing.
Controlled variationsWhen a stable brief should be rerun while changing only documented inputs.
Prototype to scaleWhen the same meta/sam-3-1/image contract should serve a single experiment and a larger batch later.

Prompt Guide

Lead with the subject or source, then state the transformation, important spatial or temporal details, style, and finish. Supply only documented fields, keep media URLs reachable, and vary one control at a time when comparing outputs.

{
  "prompt": "wheel",
  "image": "https://example.com/reference.jpg"
}

Technical Specs

PropertyValue
Model IDmeta/sam-3-1/image
Required inputsprompt
promptstring; default: wheel
image_urlstring
max_masksinteger; default: 3
sync_modeboolean; default: false
apply_maskboolean; default: true
box_promptsarray; default: []
include_boxesboolean; default: false
output_formatstring; options: jpeg, png, webp; default: png
point_promptsarray; default: []
include_scoresboolean; default: false
safety_tolerancestring; default: 6
return_multiple_masksboolean; default: false

Related Models

  • meta/sam-3-1/image-rle
  • meta/sam-3-1/video
  • meta/sam-3-1/video-rle

Related Models

meta/sam-3-1/image-rleSam 3 1 Image Rle is Meta's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.meta/sam-3-1/videoSam 3 1 Video is Meta's video-to-video AI model. Transform, enhance, and edit video content using text prompts - from style changes to object manipulation and scene modification.meta/demucsDemucs by Meta - advanced AI model for audio-to-audio. Delivers high-quality results with fast inference, suitable for both creative and production workflows.meta/sam-3/3d-alignSam 3 3d Align by Meta - advanced AI model for 3d-to-3d. Delivers high-quality results with fast inference, suitable for both creative and production workflows.meta/sam-3/3d-bodySam 3 3d Body is Meta's image-to-3D AI model. Transform photographs into production-ready 3D meshes with accurate geometry and texture mapping.meta/sam-3/3d-objectsSam 3 3d Objects by Meta - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.meta/sam-3/imageSam 3 Image is Meta's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.meta/sam-3/image-rleSam 3 Image Rle is Meta's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.