ClearCrowds 开发者

面向 AI Agent 的图片编辑 API

创建最小权限 Key,发现可用图片工作流,并使用独立于用户积分的 API Credits 计费。

打开开发者平台

快速开始

在开发者平台创建项目和 API Key,并把 Key 保存到服务端环境变量中。

# .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 列表

复制公开 Preset ID 用于接入,再打开对应编辑器流程检查实际效果。

Enhance Image, 修改前
Enhance Image, 修改后

Enhance Image

Improve clarity, lighting, and overall image quality.

enhance-image

100 API Credits / execution

Professional Headshot, 修改前
Professional Headshot, 修改后

Professional Headshot

Turn a casual portrait into a work-ready headshot.

professional-headshot

100 API Credits / execution

Remove Crowds, 修改前
Remove Crowds, 修改后

Remove Crowds

Remove background crowds and reconstruct the scene naturally.

remove-crowds

100 API Credits / execution

Remove Clutter, 修改前
Remove Clutter, 修改后

Remove Clutter

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

remove-clutter

100 API Credits / execution

Remove Text, 修改前
Remove Text, 修改后

Remove Text

Remove visible text and rebuild the background behind it.

remove-text

100 API Credits / execution

Upscale Image, 修改前
Upscale Image, 修改后

Upscale Image

Increase image resolution while improving visible detail.

upscale-image

100 API Credits / execution

Restore Old Photo, 修改前
Restore Old Photo, 修改后

Restore Old Photo

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

restore-old-photo

100 API Credits / execution

Remove Reflection, 修改前
Remove Reflection, 修改后

Remove Reflection

Remove glass or mirror reflections and recover obscured content.

remove-reflection

100 API Credits / execution

Remove Shadow, 修改前
Remove Shadow, 修改后

Remove Shadow

Remove distracting shadows while preserving natural lighting.

remove-shadow

100 API Credits / execution

Remove Person, 修改前
Remove Person, 修改后

Remove Person

Remove people from a photo and reconstruct the background.

remove-person

100 API Credits / execution

Remove Glasses, 修改前
Remove Glasses, 修改后

Remove Glasses

Remove eyeglasses and restore natural eye detail.

remove-glasses

100 API Credits / execution

Remove Glare, 修改前
Remove Glare, 修改后

Remove Glare

Reduce harsh glare while preserving the underlying image.

remove-glare

100 API Credits / execution

接口文档

先把本地图片上传为 Project 临时 Asset,再创建幂等 Job、轮询状态,最后通过鉴权接口下载结果。

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

人工使用时通过浏览器完成设备授权,CI 使用 CLEARCROWDS_API_KEY。CLI 直接上传本地文件,并以原子写入方式保存完整结果。

安装

Private Beta 期间 CLI 不发布到 npm。获得私有源码后,在仓库根目录执行以下命令(需要 Node.js 20.19+)。

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

登录并改图

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 = 100 API Credits,最低充值 100 USD。Credits 归属于单个开发者项目,与 ClearCrowds Points 完全独立。

1 USD
100 Credits
Minimum
$100
Payment
Polar / USDT