Cut one object out of a photo

Targets a single object by text prompt or by a point on it. Costs 1 credit, like /images/remove-background, refunded when the cutout fails. Hidden from the MCP tools/list on a build where the service is not configured; this door then answers that the feature is off.

post/images/extract-object

Request

  • Base URL: https://rendry.io/api/v1
  • URL: https://rendry.io/api/v1/images/extract-object
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Headers

X-Rendry-Accountstring

Browser/OAuth current member account selector. API keys/embed credentials are bound to their persisted account and reject another account. Omitting this header selects the browser actor personal account.

Request body

urlstring
storage_keystring
promptstring

Short English concept: "coffee cup", "the dog"

filenamestring

Response

Cutout saved to assets

urlstring required

Absolute URL of the PNG; served to the owner only, like every user asset

storage_keystring required
file_namestring required
hintstring
evicted_notestring

Sent when the asset slots were full and the OLDEST previous cutout was removed to make room

image_base64string

A JPEG preview of the cutout

mime_typestring

Changes

No recorded changes to this operation across all 1 revision of this API.