ClearCrowds 开发者

面向 AI Agent 的图片编辑 API

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

打开开发者平台

快速开始

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

所有 API Key 必须保存在服务端,并只授予 Agent 实际需要的权限。

# .env.local,请勿提交此文件
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

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

Professional Headshot

Turn a casual portrait into a work-ready headshot.

professional-headshot

每次执行 100 API Credits

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

Remove Crowds

Remove background crowds and reconstruct the scene naturally.

remove-crowds

每次执行 100 API Credits

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

Remove Clutter

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

remove-clutter

每次执行 100 API Credits

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

Remove Text

Remove visible text and rebuild the background behind it.

remove-text

每次执行 100 API Credits

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

Upscale Image

Increase image resolution while improving visible detail.

upscale-image

每次执行 100 API Credits

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

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

Remove Reflection

Remove glass or mirror reflections and recover obscured content.

remove-reflection

每次执行 100 API Credits

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

Remove Shadow

Remove distracting shadows while preserving natural lighting.

remove-shadow

每次执行 100 API Credits

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

Remove Person

Remove people from a photo and reconstruct the background.

remove-person

每次执行 100 API Credits

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

Remove Glasses

Remove eyeglasses and restore natural eye detail.

remove-glasses

每次执行 100 API Credits

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

Remove Glare

Reduce harsh glare while preserving the underlying image.

remove-glare

每次执行 100 API Credits

接口文档

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

GET/api/v1/catalog/presets

公开

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。API Credits 归属于单个开发者项目,与 ClearCrowds 编辑 Credits 完全独立。

1 USD
100 Credits
最低充值
$100
支付方式
Polar / USDT