specification: API Commons Rate Limits
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/RateLimits
provider: Photoroom
providerId: photoroom
created: '2026-05-08'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-08, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-08'
reconciled: partial
tags:
- AI
- Image Editing
- Background Removal
- E-commerce
- Visual
- Rate Limiting
- Quotas
- Throttling
description: >-
  Photoroom rate-limits primarily through plan-based image quotas (paid plans are usage-billed
  per image; free tier gives 10 basic + 1,000 sandbox calls/month). Specific HTTP RPS caps
  are not publicly documented. Sandbox mode supports unlimited testing.
notes: Plan-based image budget is the primary control mechanism; HTTP RPS caps not public.
sources:
- https://www.photoroom.com/api/pricing
- https://docs.photoroom.com/
responseCodes:
  throttled: 429
limits:
- name: Free Basic Images / Month
  scope: account
  metric: images
  limit: 10
- name: Free Sandbox Image Editing Calls / Month
  scope: account
  metric: calls
  limit: 1000
- name: HTTP Requests
  scope: account
  metric: requests
  limit: not publicly documented
policies:
- name: Backoff Strategy
  description: Clients should implement exponential backoff with jitter and honor any Retry-After header.
- name: Sandbox Testing
  description: Use sandbox mode to validate integrations without consuming production credits.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com