Sam 2 Auto Segment.

Sam 2 Auto Segment Overview

SAM2 Auto Segment creates image segmentation masks from a source image, returning combined and individual masks for object isolation workflows.

Automatic sampling and filtering generate masks for objects in an input image.

Sam 2 Auto Segment is available through each::labs in the utility-tools family. Required fields are image_url.

output_format: Output mask image format. points_per_side: Number of points sampled along each side.

Use the Sam 2 Auto Segment API when you need this transformation or analysis as a repeatable step in an application or creative pipeline. The sections below distinguish the required material, adjustable controls and checks that matter before delivery.

Capabilities

• Automatic sampling and filtering generate masks for objects in an input image.
• output_format: Output mask image format.
• points_per_side: Number of points sampled along each side.
• pred_iou_thresh: Predicted IoU threshold for mask filtering.
• image_url: URL of the image to segment.

Use Cases for Sam 2 Auto Segment

Sam 2 Auto Segment is useful when this specific operation fits between source preparation and delivery. These scenarios show how it can support different parts of a working pipeline.

Creators

Isolate regions for an image edit. Use a representative source or a concise brief, then inspect the result before preparing a larger set of assets.

Design and marketing teams

Prepare object masks for compositing. Compare the result with the intended message, composition and destination. Keep reviewable versions of the source and output.

Developers

Inspect candidate foreground segments. Inspect the actual returned value before connecting it to another step, and keep the chosen request settings with the result.

Start with a clear definition of the desired result and use the exposed controls to reach it. Keep any additional generation, editing or application logic in separate steps so that the effect of this operation remains easy to review.

Tips and Tricks

Start with the best available source and choose a target that fits the delivery need. Use restrained enhancement or segmentation settings first, then inspect the relevant regions before increasing the effect.

• points_per_side: Number of points sampled along each side.
• pred_iou_thresh: Predicted IoU threshold for mask filtering.

Set the named operation controls directly. This entry has no general creative-prompt interface; supplying an invented prompt field will not replace a required source or numeric setting.

Compare one deliberate adjustment at a time. Inspect the part of the result affected by that change, then check the rest of the asset or response for unwanted side effects before reusing the settings.

Technical Specifications

• Result type: object.
• Required fields: image_url.
• output_format: string; options png, jpeg; default "png".
• points_per_side: integer; default 32; minimum 1; maximum 128.
• pred_iou_thresh: number; default 0.88; minimum 0; maximum 1.
• stability_score_thresh: number; default 0.95; minimum 0; maximum 1.

image_url: URL of the image to segment.

Values must use the types and accepted options listed in the parameter reference. A displayed default does not remove a required-field requirement. Choose a supported output setting for this entry rather than borrowing a preset from a related model.

Things to Be Aware Of

Compare source and result side by side. Inspect texture, edges, small text and faces where present; an inferred enhancement or mask should not be treated as a recovered record of missing original detail.

Optional settings are not necessarily interchangeable with those on another entry in the same family. Use the accepted names, types and values shown for this operation.

For media-based inputs, supply a directly retrievable file URL rather than a page containing the asset. Keep the source available while processing. Check the final content in the destination player, editor or application, not only the request status.

Key Considerations

Sampling density and filtering thresholds affect which regions remain; small, overlapping or ambiguous objects need mask review.

Execution-time pricing: $0.001/sec based on run_time.

Prepare image_url before starting. Optional settings include output_format, points_per_side, pred_iou_thresh. Keep these settings aligned with the intended delivery, especially when a later step expects a particular type or format.

Run a representative request before scaling to a larger collection. Judge the result against the source and the brief, and account for all generated outputs or usage-sensitive options when estimating a batch.

Limitations

• output_format: allowed values: ["png", "jpeg"].
• points_per_side: minimum: 1; maximum: 128.

Unsupported parameters do not establish additional capabilities. A generated result can differ from the intended brief, so review detail and consistency before publication.