ClearCrowds Developers

Image editing APIs for AI agents

Create a scoped key, discover available workflows, and keep API billing separate from consumer points.

Open developer dashboard

Quickstart

Create a project and API key in the developer dashboard. Save the key as a server-side environment variable.

# .env.local, never commit this file
CLEARCROWDS_API_KEY=cc_live_...
curl "https://app.clearcrowds.com/api/v1/presets" \
  -H "Authorization: Bearer $CLEARCROWDS_API_KEY"

Preset catalog

Copy the public preset ID for your integration, then open the matching editor workflow to test the result.

Enhance Image, Before
Enhance Image, After

Enhance Image

Improve clarity, lighting, and overall image quality.

enhance-image

100 API Credits / execution

Professional Headshot, Before
Professional Headshot, After

Professional Headshot

Turn a casual portrait into a work-ready headshot.

professional-headshot

100 API Credits / execution

Remove Crowds, Before
Remove Crowds, After

Remove Crowds

Remove background crowds and reconstruct the scene naturally.

remove-crowds

100 API Credits / execution

Remove Clutter, Before
Remove Clutter, After

Remove Clutter

Clear visual clutter while preserving the room and its main subjects.

remove-clutter

100 API Credits / execution

Remove Text, Before
Remove Text, After

Remove Text

Remove visible text and rebuild the background behind it.

remove-text

100 API Credits / execution

Upscale Image, Before
Upscale Image, After

Upscale Image

Increase image resolution while improving visible detail.

upscale-image

100 API Credits / execution

Restore Old Photo, Before
Restore Old Photo, After

Restore Old Photo

Repair scratches, damage, fading, and lost detail in old photos.

restore-old-photo

100 API Credits / execution

Remove Reflection, Before
Remove Reflection, After

Remove Reflection

Remove glass or mirror reflections and recover obscured content.

remove-reflection

100 API Credits / execution

Remove Shadow, Before
Remove Shadow, After

Remove Shadow

Remove distracting shadows while preserving natural lighting.

remove-shadow

100 API Credits / execution

Remove Person, Before
Remove Person, After

Remove Person

Remove people from a photo and reconstruct the background.

remove-person

100 API Credits / execution

Remove Glasses, Before
Remove Glasses, After

Remove Glasses

Remove eyeglasses and restore natural eye detail.

remove-glasses

100 API Credits / execution

Remove Glare, Before
Remove Glare, After

Remove Glare

Reduce harsh glare while preserving the underlying image.

remove-glare

100 API Credits / execution

API reference

Upload a local image as a temporary project asset, create an idempotent job, poll its status, then download the authenticated result.

GET/api/v1/catalog/presets

public

GET/api/v1/presets

presets:read

POST/api/v1/assets

files:write

POST/api/v1/presets/:presetId/jobs

jobs:write

POST/api/v1/eraser/jobs

jobs:write

POST/api/v1/resize/jobs

jobs:write

POST/api/v1/ocr/detections

jobs:write

POST/api/v1/ocr/edits

jobs:write

GET/api/v1/jobs/:jobId

jobs:read

GET/api/v1/jobs/:jobId/result

jobs:read

GET/api/v1/account

billing:read

curl "https://app.clearcrowds.com/api/v1/account" \
  -H "Authorization: Bearer $CLEARCROWDS_API_KEY"

Private Beta CLI

The CLI uses browser-based device authorization for people and CLEARCROWDS_API_KEY for CI. It uploads local files directly to the API and writes completed results atomically.

Install

The CLI is not published to npm during Private Beta. After receiving the private source, run this from the repository root (Node.js 20.19+ required).

npm install --global ./packages/agent-tools
clearcrowds setup

Sign in and edit

clearcrowds login
clearcrowds edit ./input.jpg --preset remove-crowds --output ./fixed.jpg
clearcrowds resize ./fixed.jpg --width 1200 --height 630 --output ./social.jpg

API Credits

$1 USD equals 100 API Credits. The minimum top-up is $100. Credits belong to one developer project and are separate from ClearCrowds Points.

1 USD
100 Credits
Minimum
$100
Payment
Polar / USDT