README.md

---
title: Free SAM3 Text-to-Mask
emoji: ✂️
colorFrom: red
colorTo: yellow
sdk: gradio
sdk_version: 6.17.3
python_version: '3.13'
app_file: app.py
pinned: false
license: apache-2.0
short_description: Provided by SegmentationAPI.com - text-prompted segmentation
---

# ✂️ SAM 3 Text → Mask - Free Demo

Type what you want to segment in plain English ("person", "car, traffic light", "building") and get pixel-perfect instance masks, powered by Meta's **SAM 3**.

⚡ This Space is a free, rate-limited demo of **[SegmentationAPI](https://www.segmentationapi.com)**:

- Images are downscaled to 1024px
- Limited requests per hour per visitor
- Images only

👉 **[Get your own API key](https://www.segmentationapi.com)** for full resolution, **video segmentation**, and batch processing. See the [API docs](https://www.segmentationapi.com/docs).

## How it works

The app calls the same public REST API you'd integrate with:

1. `POST /v1/uploads/presign` → upload your image
2. `POST /v1/jobs` with text prompts
3. Poll `GET /v1/jobs/{jobId}` → download masks