Cutouts

Get a cutout's status and signed URLs

Returns the current cutout state for a generation and fresh signed URLs for all output files. URLs are time-limited (~1 hour) — re-fetch this endpoint when they expire rather than caching them long-term. If the cutout is still processing, status will be pending and the URL fields will be absent.

get/v1/cutouts/{generation_id}

Request

  • Base URL: https://nanostudiopro.com/api
  • URL: https://nanostudiopro.com/api/v1/cutouts/{generation_id}
  • Auth: HTTP bearer

Response

Cutout state and signed URLs.

generation_idstring

ID of the generation this cutout belongs to.

status'pending' | 'ready' | 'failed'

ready once all outputs are stored; pending while processing; failed on unrecoverable error.

cutout_urlstring uri nullable

Signed URL for the transparent-background WebP subject cutout. Omitted if compositing produced no foreground.

matte_urlstring uri nullable

Signed URL for the grayscale alpha matte (PNG). White = subject, black = background.

bg_plate_urlstring uri nullable

Signed URL for the subject-removed background plate (PNG).

Changes

No recorded changes to this operation across all 2 revisions of this API.