Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Photoroom / Photoroom image APIs

Background Removal

Managed foreground cutout and alpha-mask service, available through Basic segmentation and Plus image-editing routes.

availableClosed-source managed componentImage processing
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
4 of 20 specification fields collected
Image input limitNot collectedAwaiting source review
Output typesImageSee specification notes below
Input billingSee ratesPhotoroom Remove Background API
Output billingSee ratesPublished units and conditions below

Specifications

Provider-documented facts. “Not collected” means we have not verified that field yet, not that the feature is unsupported.

Context / input limit
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Maximum input tokens
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Maximum output
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Maximum prompt characters
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Reasoning
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Tool calling
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Structured output
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Streaming
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Batch processing
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Fine-tuning
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Context caching
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Knowledge cutoff
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Release date
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Parameters
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Architecture
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Languages
Not collected

Not established for this exact image model or managed deployment. No language-model capabilities are inferred from HTTP or JSON transport.

Image input limits
Basic: 50 MB / 6,000 px; Plus: 30 MB / 5,000 pxSource for Image input limits (opens in a new tab)

Different routes have different file limits and format support.

Output formats
PNG, JPEG, WebPSource for Output formats (opens in a new tab)

Basic route formats. The Plus route also supports AVIF.

Access & pricing

Prices belong to an endpoint and billing tier. A provider listing does not guarantee access for every account or region.

Photoroom Remove Background API

Provider source (opens in a new tab)
API model ID
Not collected

No exact base-model selector established; this route can be a managed pipeline.

Access
API key required
Regions
Eastern USA (provider API FAQ); finer deployment regions not specified
API endpoint URL
POST https://sdk.photoroom.com/v1/segmentSource for API endpoint URL (opens in a new tab)
Request quotas
Default 60 images/minute; larger Enterprise quotas by agreement. Parallel calls do not bypass the quota.Source for Request quotas (opens in a new tab)

May 2025 changelog says existing customers retain their prior settings.

Bulk processing
One image per call; parallel requests supported within account rate limits. No discounted asynchronous Batch contract established.Source for Bulk processing (opens in a new tab)
Required request fields
image_file: required binary file in multipart/form-data. This Basic route does not accept image URLs directly.Source for Required request fields (opens in a new tab)
Input file formats
PNG, JPEG, WebP, HEICSource for Input file formats (opens in a new tab)
Input limits
50 MB and a 6,000-pixel longest edge. 25 MP recommended for performance.Source for Input limits (opens in a new tab)
Generation controls
format: png (default), jpg, webp. channels: rgba (default) or alpha mask. crop and despill are string booleans, default false.Source for Generation controls (opens in a new tab)
Output sizing
size: preview (0.25 MP), medium (1.5 MP), hd (4 MP), full (36 MP, default). These are output sizing modes, not new model versions.Source for Output sizing (opens in a new tab)
How to interpret scores
x-uncertainty-score: 0 confident, 1 unsure, -1 unavailable (for example human images). Scores may change across model updates; this is not an accuracy probability guarantee.Source for How to interpret scores (opens in a new tab)
Provider-reported latency
Provider reports median 350 ms for background removal; workload and percentile tail not specified, not an SLA.Source for Provider-reported latency (opens in a new tab)
Billing conditions
Basic plan: $0.02 per API call.Source for Billing conditions (opens in a new tab)
Usage accounting
Successful calls consume the image allowance; calls returning an error do not.Source for Usage accounting (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 15 Oct 2026
CategoryUsageRateUnit
Image API usageBackground removal1$0.02successful API call

Rate conditions

  1. Published Basic/Plus plan rate. A single combined edit call is charged once, not once per enabled feature. Separate calls are billed separately; account-specific Enterprise pricing may differ. No text-token or per-question conversion.
Pricing source (opens in a new tab)

Data & enterprise terms

Provider FAQ says API images are not saved. This is not a full account-data, log-retention or training-use policy.

Read the service policy (opens in a new tab)

Photoroom Image Editing API

Provider source (opens in a new tab)
API model ID
Not collected

No exact base-model selector established; this route can be a managed pipeline.

Access
API key required
Regions
Eastern USA (provider API FAQ); finer deployment regions not specified
API endpoint URL
GET or POST https://image-api.photoroom.com/v2/editSource for API endpoint URL (opens in a new tab)
Request quotas
Default 60 images/minute; larger Enterprise quotas by agreement. Parallel calls do not bypass the quota.Source for Request quotas (opens in a new tab)

May 2025 changelog says existing customers retain their prior settings.

Bulk processing
One image per call; parallel requests supported within account rate limits. No discounted asynchronous Batch contract established.Source for Bulk processing (opens in a new tab)
Request format
GET /v2/edit accepts imageUrl and query parameters. POST /v2/edit uses imageFile with multipart form fields; do not put POST options in the query string.Source for Request format (opens in a new tab)
Input file formats
PNG, JPEG, WebP, AVIFSource for Input file formats (opens in a new tab)
Output formats
PNG, JPEG, WebP, AVIFSource for Output formats (opens in a new tab)

PNG default; JPEG cannot preserve transparency. JPEG/WebP quality 90, AVIF quality 75 in the guide.

Input limits
30 MB file maximum. Larger images are resized to a 5,000-pixel longest edge. 25 megapixels is a recommendation, not an additional rejection threshold.Source for Input limits (opens in a new tab)
Output sizing
outputSize: auto (default), originalImage, croppedSubject or WIDTHxHEIGHT. Auto uses template dimensions when templateId is provided, otherwise original-image dimensions.Source for Output sizing (opens in a new tab)
Billing conditions
Plus plan: $0.10 per successful call, including combined edit options. Identical repeated requests are billed again. Enterprise/custom contracts can differ.Source for Billing conditions (opens in a new tab)
Free usage allowance
Watermarked sandbox: 1,000 calls/month, maximum 100/day. Prefix API key with sandbox_. No request was submitted during this review.Source for Free usage allowance (opens in a new tab)
Documentation discrepancy
General FAQ lists only PNG/JPEG/WebP and sRGB. Dedicated editing guide additionally documents AVIF and restricted original-ICC preservation for plain PNG background removal.Source for Documentation discrepancy (opens in a new tab)
Generation controls
removeBackground=true. pr-hd-background-removal:auto improves edge detail on high-resolution images; recommended at 2K and above, not a separate model identity.Source for Generation controls (opens in a new tab)
Color-space handling
colorSpace=original preserves input ICC only for plain background removal with PNG output. Other edits, non-PNG, export.dpi, retained alpha and EXIF-subset metadata modes are rejected. Default output is sRGB.Source for Color-space handling (opens in a new tab)

Prices retain their published currencies and billing units below.

Published billing units · original currency · observed 15 Oct 2026
CategoryUsageRateUnit
Image API usageImage editing, including background removal1$0.10successful API call

Rate conditions

  1. Published Basic/Plus plan rate. A single combined edit call is charged once, not once per enabled feature. Separate calls are billed separately; account-specific Enterprise pricing may differ. No text-token or per-question conversion.
Pricing source (opens in a new tab)

Data & enterprise terms

Provider FAQ says API images are not saved. This is not a full account-data, log-retention or training-use policy.

Read the service policy (opens in a new tab)

Caching

Caching can reuse earlier input processing. Availability, lifetime and billing depend on the endpoint. A cache hit still generates a new response.

01 / INITIAL INPUTProcess & retain

The system processes eligible input and retains reusable state.

02 / LATER REQUESTCheck available state

Reuse depends on matching input, session state and the cache policy.

03 / CACHE HITReuse & generate

Reusing state can reduce repeated work. Any charges follow the billing rules below.

Photoroom Remove Background API

Not verified

No reviewed cache contract for this route.

How it works
Not collected

No reviewed cache contract for this route.

Minimum reusable input
Not collected

No reviewed cache contract for this route.

Lifetime & refresh
Not collected

No reviewed cache contract for this route.

How to enable it
Not collected

No reviewed cache contract for this route.

Usage fields
Not collected

No reviewed cache contract for this route.

Billing rules
Not collected

No reviewed cache contract for this route.

Limits & data boundaries
Not collected

No reviewed cache contract for this route.

No verified cache rate for this endpoint. An empty rate is not a zero charge.

Caching reviewed 15 Oct 2026

What the measurements say

No benchmark observations have been added for this model. We do not turn a vendor description into a performance score.

Latency and throughput depend on the host, request size, reasoning settings and load. There is no measured speed or global usage figure in this record.

The record behind the model

Why it is included

Managed deployment, not a separately established private base checkpoint. Photoroom documents this model-backed workflow, but exact private derivative identity and the mapping to Instant Diffusion or third-party models remain unresolved. API versions, presets and transports do not establish new foundation models.

Classification evidence (opens in a new tab)

Sources reviewed