sam3-api

Provide a Python API for promptable SAM3 segmentation on images and videos.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/tordks/cc-plugins --skill sam3-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sam3-api
Source: https://github.com/tordks/cc-plugins/tree/main/plugins/image-analysis/skills/sam3
Command: npx skills add https://github.com/tordks/cc-plugins --skill sam3-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

SAM3 prompts-based segmentation is made accessible via a unified Python API, enabling developers to apply text, bounding box, and point prompts to images and videos without bespoke tooling.

Core Features & Use Cases

  • Text prompts for open-vocabulary segmentation on images and videos
  • Geometric prompts via bounding boxes with positive/negative labels
  • Point prompts (click-based) and video tracking across frames
  • Batch inference and model-building guidance for fast experimentation

Quick Start

Install the SAM3 API, load a model, and start segmenting images or videos with prompts.

Frequently Asked Questions about sam3-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use text prompts for image and video segmentation with SAM3?

Text prompts enable open-vocabulary segmentation with SAM3 by passing descriptive text to the API. The unified Python API processes these prompts to isolate target objects across static images and video streams without requiring bespoke tooling.

What is the best way to apply bounding box and point prompts for SAM3 video tracking?

Geometric prompts like bounding boxes with positive or negative labels, alongside point prompts, drive SAM3 video tracking. You apply these click-based prompts to initial frames, and the API streams segmentation masks across subsequent video frames programmatically.

Can I perform batch inference on multiple images using the SAM3 Python API?

Batch inference is supported natively by the SAM3 Python API, allowing you to process multiple images simultaneously. This integrates with model-building guidance to enable fast experimentation and high-throughput promptable segmentation workflows.

Do I need PyTorch to use the SAM3 API for promptable segmentation?

PyTorch is required as the SAM3 API relies on PyTorch-based data structures and post-processing implementations. The API exposes Python interfaces to load the SAM3 model, set images, and apply prompts compatible with this framework.

How does SAM3 segmentation handle the transition from static images to streaming video?

SAM3 provides an integrated workflow that applies the same prompt types to both static images and streaming video. The API manages video tracking by propagating segmentation masks across frames, maintaining object continuity throughout the stream.

Why use a unified API for SAM3 instead of custom segmentation tooling?

A unified API eliminates the need for bespoke tooling by exposing text, box, and point prompts through a single Python interface. This streamlines model building and ensures consistent post-processing across both image and video segmentation tasks.