SAM 3 Image
Image editing
Starting price $0.01 / request
Mark the part of a photo you want to isolate. SAM 2 Image uses your points or box to identify the subject and produces a mask for the selected region.
sam2/imageQuote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.
# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
-H "Authorization: Bearer $RAYWAKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sam2/image",
"input": {
"image_url": "https://example.com/input.png"
}
}'
# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
-H "Authorization: Bearer $RAYWAKE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"model": "sam2/image", "quote_id": "QUOTE_ID", "input": {"image_url":"https://example.com/input.png"}}'
# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
-H "Authorization: Bearer $RAYWAKE_API_KEY"| Name | Type | Description |
|---|---|---|
image_urlrequired | string (image URL) | URL of the image to be segmented |
prompts | array of objects | List of prompts to segment the image |
box_prompts | array of objects | Coordinates for boxes |
apply_mask | boolean | Apply the mask on the image. |
sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
output_format | string (enum) | The format of the generated image. |
A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.
"outputs": [
{ "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]The exact charge for your input comes from a quote. How charges settle
Fields marked * are required. Review the price before generating.
Upload an image and mark what you want with point coordinates or a box. Each point is labeled as foreground (part of the object) or background (not part of it). The result is the segmented image as PNG, JPEG or WebP, and you can choose to apply the mask onto the image.
Check selected boundaries and excluded regions; inspect the output format before relying on transparency.