Segment Anything 3 - Image

Try Segment Anything 3 - Image in the Workbench

Run this model interactively, tune parameters, and compare outputs.

Model ID: sam-3-image Segment Anything 3 - Image is a Large Vision Model (LVM). It excels in zero-shot image segmentation, detecting and segmenting all instances of objects based on text or visual prompts like points and boxes, offering a unified interface for concept-driven tasks over earlier geometry-only models. Some other noteworthy features of Segment Anything 3 - Image include exhaustive instance detection (finding every matching object in an image) and a presence head that checks concept existence before localization to reduce false positives.

Metric	Value
Parameter Count	848 million
Mixture of Experts	Unknown
Context Length	Unknown
Multilingual	No
Quantized*	Unknown

*Quantization is specific to the inference provider and the model may be offered with different quantization levels by other providers.

Example request

Use the Workbench as a request builder: configure parameters for this model in the UI, then open the API tab to copy the exact cURL or Python call.

Sync
Async
Async with SSE

See the image editing reference for more details.

Minimal
All parameters

curl -X POST https://hub.oxen.ai/api/ai/images/edit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "sam-3-image",
  "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
  "prompt": "the ox horns"
}'

curl -X POST https://hub.oxen.ai/api/ai/images/edit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "sam-3-image",
  "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
  "prompt": "the ox horns",
  "apply_mask": true,
  "output_format": "png"
}'

See the async queue reference for more details.

Minimal
All parameters

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "sam-3-image",
  "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
  "prompt": "the ox horns"
}' | jq -r '.generations[0].generation_id')

# Poll the single generation until it 404s (terminal state).
while curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do
  sleep 5
done
echo "Done. See the 'Async with SSE' tab to receive the result URL."

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "sam-3-image",
  "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
  "prompt": "the ox horns",
  "apply_mask": true,
  "output_format": "png"
}' | jq -r '.generations[0].generation_id')

# Poll the single generation until it 404s (terminal state).
while curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Bearer $OXEN_API_KEY" \
    "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do
  sleep 5
done
echo "Done. See the 'Async with SSE' tab to receive the result URL."

See the async queue reference for more details.

Minimal
All parameters

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "sam-3-image",
  "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
  "prompt": "the ox horns"
}' | jq -r '.generations[0].generation_id')

# Stream the SSE channel, grab the data line that follows a
# media_generation_completed event for our id, and pretty-print it.
curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \
  | awk -v id="$GEN_ID" '
    /^event: media_generation_completed$/ { expect=1; next }
    /^data: / && expect {
      payload = substr($0, 7)
      if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit }
      expect = 0
    }
  ' | jq .

# Enqueue, capture the generation id.
GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OXEN_API_KEY" \
  -d '{
  "model": "sam-3-image",
  "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png",
  "prompt": "the ox horns",
  "apply_mask": true,
  "output_format": "png"
}' | jq -r '.generations[0].generation_id')

# Stream the SSE channel, grab the data line that follows a
# media_generation_completed event for our id, and pretty-print it.
curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \
  | awk -v id="$GEN_ID" '
    /^event: media_generation_completed$/ { expect=1; next }
    /^data: / && expect {
      payload = substr($0, 7)
      if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit }
      expect = 0
    }
  ' | jq .

Fetch model details

The models endpoint returns the full model object, including its json_request_schema.

curl -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/ai/models/sam-3-image

Request parameters

Required parameters

Field	Type	Default	Description
`input_image`	`string`	`"https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png"`	Image to use as reference. Must be jpeg, png, gif, or webp. Format: uri.
`prompt`	`string`	`"the ox horns"`	Text description of what you want to segment out of the image.

Optional parameters

Field	Type	Default	Description
`apply_mask`	`boolean`	`true`	Apply the mask on the image.
`output_format`	`string`	`"png"`	Format of the output images One of: jpg, png.

Inference API

Try Segment Anything 3 - Image in the Workbench

​Example request

​Fetch model details

​Request parameters

​Required parameters

​Optional parameters

Example request

Fetch model details

Request parameters

Required parameters

Optional parameters