Segment Anything (SAM)— click once, get a perfect mask.

import os, base64
import requests
from pathlib import Path

api_key = os.environ["MSF_API_KEY"]

resp = requests.post(
    "https://api.msightflow.ai/v1/segment/interactive",
    headers={"Authorization": f"Bearer {api_key}"},
    files={"image": Path("image.jpg").read_bytes()},
    data={
        "points": '[{"x": 320, "y": 240, "label": 1}]',  # 1 = foreground
        "return_overlay": "true",
    },
)
result = resp.json()

# Save the mask
Path("mask.png").write_bytes(base64.b64decode(result["mask"]))
print("bbox:", result["bbox"], "confidence:", result["confidence"])

import fetch from "node-fetch";
import FormData from "form-data";
import fs from "fs";

const form = new FormData();
form.append("image", fs.createReadStream("image.jpg"));
form.append("points", JSON.stringify([{ x: 320, y: 240, label: 1 }]));
form.append("return_overlay", "true");

const resp = await fetch("https://api.msightflow.ai/v1/segment/interactive", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.MSF_API_KEY}` },
  body: form,
});
const result = await resp.json();
console.log("bbox:", result.bbox, "confidence:", result.confidence);

curl -X POST https://api.msightflow.ai/v1/segment/interactive \
  -H "Authorization: Bearer $MSF_API_KEY" \
  -F "image=@image.jpg" \
  -F 'points=[{"x":320,"y":240,"label":1}]' \
  -F "return_overlay=true"

# "Everything mode": auto-mask every object in the image.
resp = requests.post(
    "https://api.msightflow.ai/v1/segment/everything",
    headers={"Authorization": f"Bearer {api_key}"},
    files={"image": Path("image.jpg").read_bytes()},
    data={"points_per_side": "16"},   # 4 (coarse) - 32 (fine)
)
result = resp.json()
# result["masks"]: list of {mask: base64, bbox, confidence}
print(f"Found {len(result['masks'])} distinct objects")