You can deploy this model and start earning money today!

austere-moose/
ester-sam3-face-parts

Name: ester-sam3-face-parts
Availability: InStock

endpoints_compatible

Views

No views yet

SAM3 Face Parts Model Repo

This folder is the source content for the Hugging Face model repository at:

austere-moose/ester-sam3-face-parts

That repo exists as the control-plane home for the hosted SAM3 face-part service.

Important Runtime Note

Do not deploy this repo with the stock Hugging Face handler.py endpoint runtime.

Why:

Hugging Face Inference Endpoints currently document a default runtime based on transformers 4.48.0
facebook/sam3 was added in Transformers v5
upgrading only transformers in the stock endpoint runtime breaks the older Hugging Face inference toolkit import path

In practice, the default custom-handler path currently crashes before our code starts.

Supported Hosting Path

Use a custom container on Hugging Face Inference Endpoints instead.

The custom container source lives beside this folder:

../custom_container

That container owns the web server and dependencies, so we are not coupled to the stock inference toolkit.

Why Keep This Repo

We still want a canonical Hugging Face repo under the org because it gives us:

one obvious SAM3 service home under austere-moose
a stable repo to point the endpoint at
a place for service docs, future prompt configs, and version notes

Request Shape

The custom container accepts:

json

{
  "inputs": {
    "image_b64": "<base64 png or jpeg>",
    "parts": ["forehead", "nose", "left_cheek", "right_cheek", "chin"],
    "threshold": 0.5,
    "mask_threshold": 0.5,
    "min_area_ratio": 0.00005
  }
}

or:

json

{
  "inputs": {
    "image_url": "https://..."
  }
}

Response Shape

json

{
  "model_id": "facebook/sam3",
  "device": "cuda",
  "image_size": [1080, 1440],
  "parts": {
    "forehead": {
      "mask_png_b64": "<base64 png or null>",
      "mask_present": true,
      "mask_area_ratio": 0.0412,
      "prompt_runs": [
        {"prompt": "forehead", "kept_instances": 1}
      ]
    }
  }
}

austere-moose/ester-sam3-face-parts

SAM3 Face Parts Model Repo

Important Runtime Note

Supported Hosting Path

Why Keep This Repo

Request Shape

Response Shape

austere-moose/
ester-sam3-face-parts