Skip to content
Model infoModelsSnapshot: 15 Oct 2026

Photoroom / Photoroom image APIs

AI Shadows 2026-04-15

Managed shadow generation with independent controls for softness, darkness, spread, direction and subject pose.

Image analysis & processing
availableClosed-source managed componentImage processing
Official documentation (opens in a new tab)Reviewed 15 Oct 2026
5 of 20 specification fields collected
Image input limitNot collectedAwaiting source review
Output typesImageSee specification notes below
Input billingSee ratesPhotoroom Image Editing 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 supportedSource for Context caching (opens in a new tab)

Identical Image Editing API calls are billed separately; no result caching available.

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.

Input modalities
ImageSource for Input modalities (opens in a new tab)
Output modalities
ImageSource for Output modalities (opens in a new tab)
Output formats
PNG, JPEG, WebP, AVIFSource for Output formats (opens in a new tab)
Image input limits
30 MB; resized to a 5,000-pixel longest edgeSource for Image input limits (opens in a new tab)

Access & pricing

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

Photoroom Image Editing API

Provider source (opens in a new tab)
API model ID
2026-04-15

pr-ai-shadows-model-version header; not a full API path.

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)
Authentication
x-api-key headerSource for Authentication (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)
Model selection
pr-ai-shadows-model-version:2026-04-15 and shadow.mode=ai.auto-with-overrides are both required.Source for Model selection (opens in a new tab)
Shadow controls
softnessOverride and intensityOverride: 0–1. spreadOverride: 0–90 degrees or short/medium/long (10/45/90). directionOverride: angle or eight named compass-like presets around the subject. subjectPoseOverride: 0–90 degrees or flatlay/upright. Send numbers without a degree symbol.Source for Shadow controls (opens in a new tab)
Generation controls
Unset controls are inferred automatically. Provider describes fully specified five-control shadows as deterministic; this is not a result-cache or reproducibility guarantee for other edits.Source for Generation controls (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 AI shadows1$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.

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)

Lifecycle dates

New shadow model API documented in changelog21 Apr 2026Source (opens in a new tab)

Sources reviewed